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Preface 


This IBM® Redbooks® publication discusses the value proposition of 
cross-channel solutions and describes the IBM Retail Integration Framework 
Commerce Product Strategy solution and service-oriented architecture (SOA) as 
an enabler. In depth, this book describes cross-channel processes and 
cross-channel features and proposes scenarios and configurations to meet the 
challenges in a competitive environment. 

This book describes the latest features and techniques of IBM WebSphere® 
Commerce Version 7. In it, we present an overview of the WebSphere 
Commerce order and inventory management systems, the distributed order 
management (referred to as DOM throughout this book) integration framework, 
and a sample DOM integration scenario. 

We discuss the Madisons starter store (Web 2.0 storefront) and present a 
hands-on experience that integrates MapQuest with the WebSphere Commerce 
V7 Store Locator feature. We discuss how a merchant can use the mobile 
features that are included in WebSphere Commerce V7 to define e-Marketing 
Spots and promotion for mobile users. In addition, we demonstrate how to use 
Google Maps with the Store Locator feature on a mobile device. 

We include in this book an example about how to apply WebSphere Commerce 
features on a cross-channel solution as applied at the Easy Hogar y 
Construccion home improvement retail company in South America. The scenario 
explains how to scale from an SOA store to a cross-channel business model. 

This book is designed for use by WebSphere Commerce developers, 
practitioners, and solution architects in various industries. 
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Multichannel solution 
overview 


This chapter discusses the value proposition of cross channel solutions. It 
describes the IBM Retail Integration Framework, Commerce Product Strategy 
solution and service-oriented architecture (SOA) as an enabler, as well as cross 
channel processes and cross channel features. It includes scenarios and 
configurations to fit this solution into a competitive environment. 

This chapter contains the following sections: 

► Advantages of using a cross-channel solution 

► Cross-channel features 

► The IBM solution 

► Cross-channel configurations 

► Summary 
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1.1 Advantages of using a cross-channel solution 

In today’s challenging environment, businesses must deal with new and 
emerging considerations: 

► Macroeconomic conditions, such as financial crisis, growth market slow down, 
environmental concerns, product tracking, traceability for safety, fluctuating 
oil, and commodity prices. 

► Smarter consumers, where consumers are more informed and have more 
tools and channels that help them to make smarter decisions and to play an 
active role in social commerce. 

► Technology that includes an increasing number of mobile devices and the 
adoption of pervasive connectivity. 

► Budgets for companies who are looking for smart investments and who are 
developing strategic plans, because every channel has its own budget, 
strategy, and infrastructure. 

► Consistency, where companies have previously ignored the consistency and 
accuracy of product and service information across all channels throughout 
the consumers life cycle. 

These conditions call for a cross channel solution that promotes IT business 
alignment to build a more efficient and flexible business infrastructure. A cross 
channel solution builds an easy interaction between a customer and the 
company. This interaction lets the customer choose appropriate transactions. 
The cross-channel solution provides a consistent message at every transaction 
point (Web site, kiosk, call centers, store, and mobile devices) and presents the 
company’s promotions, processes, and policies coherently, wherever the 
customer might do business with the company. 

In addition, with a cross-channel solution, companies can integrate throughout all 
touchpoints and sales channels, through back-end as well as existing systems, 
and beyond the four walls of the brick-and-mortar company to suppliers, 
fulfillment partners, customers, and the entire value chain. 

The terms multichannel solutions and cross channel solutions are often used 
interchangeably, but there is a conceptual difference between these two. 

In a cross channel solution, retailers have various channels (stores, Web sites, 
catalogs, call centers, kiosk, and so forth) so that customers can make 
purchases using a method that is convenient for them. With cross channel 
solutions, retailers aim for a seamless customer experience, a unified 
customer-centric experience that leads a whole vision throughout all channels, 
including mobile commerce. 
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So by taking advantage of multichannel solutions into a cross channel 
experience, a single customer interaction platform can be put in place to provide 
a more consistent, relevant experience for customers. Cross-channel solutions 
provide the following advantages over multichannel solutions: 

► A single view of customer data and metrics throughout channels that aids in 
providing consistent data to customers (for example, credits) and better 
analysis of customer behavior. 

► Better targeted merchandising and marketing as a result of consistent and 
integrated customer behavior data. 

► A single inventory pool that takes care of lead times, demand-supply 
imbalances, and reverse logistics across all operations (buybacks, return to 
vendor, customer returns, and so forth). 

A cross channel solution provides the following general features, which are 
imperative to today’s retail industry: 

► A seamless shopping experience to shoppers 

Recent studies of consumer shopping behavior indicate that multichannel 
shoppers show a significantly higher value and frequency of purchase than 
single-channel shoppers. With a cross channel solution in place, the 
customer can choose how to interact and shop. A customer can browse and 
initiate the transaction at any point and either fulfill it in the store or ship it 
home seamlessly. Customers are provided with timely product availability and 
allocation for reliable order delivery and end-to-end visibility. 
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Figure 1-1 gives an high-level view of important cross channel solutions. 


Store Contact Store 

(Face-to-Face) Web Site Center Mobile Devices 




Choice 

Giving customers the ability to shop how they want 

Consistency 

Ensuring fulfillment of brand promise and 
customer satisfaction 

Context 

Providing the right interaction at the right time 

Continuity 

Enabling seamless flows across touchpoints 


Figure 1-1 Cross-channel solutions 


► A competitive edge for retailers 

- Multichannel allocation and execution functionality ensures the sale either 
in store or online. An option of initiating an order online and fulfilling it in 
store results in additional sales in most of the cases. 

- Precision multichannel marketing capabilities enable better analysis of 
customer attributes and buying patterns. These capabilities also enhance 
cross- or up-selling as well as targeted promotions throughout channels, 
which can increase both conversion rate and average order value by 
providing the following information: 

• The analytical capabilities and integrated information system of 
multichannel systems improve the ability to track behaviors and 
purchase history of customers and to use this data for targeted 
merchandising and marketing purposes. 

• Based on the behavioral track, the experience for customers can be 
personalized. In addition, you can more effectively target customers in 
their preferred medium with the most applicable offers and take 
advantage of cross-sell or up-sell opportunities. 
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- Consumers expect access to product information and transactional 
capability to be efficient, accurate, and delivered in the same way as by 
the retailer. Fundamentally, multichannel retailing, when delivered well, 
draws customers’ loyalty to the brand. 

When companies consider a transition from customer acquisition to 
customer retention, the primary focus moves from mass marketing to 
enabling an optimized customer experience across the multiple channels 
in which the consumer interacts with the company. Consumers expect a 
personalized experience to be available, regardless of how they interact 
with a business. 

In this environment, interactions across channels are critical in maintaining 
customer retention and loyalty. For example, ordering online and picking 
up at the store has gone from a nice-to-have option to an expected one. 
Consumers expect to shop for any item, in any channel, and complete the 
sale seamlessly — including associated services— in any other channel. 


1.2 Cross-channel features 

The importance of cross channel solutions lies in providing a customer with a 
seamless shopping experience, thus increasing customer loyalty to the brand 
and reducing total operating costs by integrating previous silo systems. A 
complete cross channel solution takes care of all aspects of both Web and 
in-store shopping. Starting from pre-store tasks to post-transaction activities in 
store and demand generation to service and support in Web-channel, everything 
is covered with one integrated solution. 
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Figure 1-2 summarizes cross channel features for a Web-to-store solution. 



Figure 1-2 Cross-channel features (Web-to-store) 


Figure 1-2 includes the following cross-channel features: 

► Pre-store activities and demand generation 

Integrated analytics, social commerce, and an inventory system help to 
gather information regarding supply and demand and help to review each 
individual product. Based on this data, the retailer can offer various 
campaigns, promotions, and in-store offers to increase demand. 

► Personalization 

The information regarding offers and promotions can be delivered to the 
customer through various points, including printed or Short Message Service 
(SMS) promotions as well as e-mail or in-store campaigning, depending on 
customer preferences. In addition, customers can be notified about 
out-of-stock items when those items arrive in store. 
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Browsing 

Customers can browse the catalog through the Web or kiosks and get the 
same results as in store. They can be offered personalized cross- or up-sell 
opportunities and promotions. They can choose to browse and transact online 
and can pick up merchandise in the store of their choice. 

Purchase decision 

Customers can make a purchase decision based on availability, price, and 
cross- or up-sell opportunities. Availability is aided through a centralized 
inventory system and gives real-time inventory information. Pricing is also 
consistent throughout all channels, because that information also comes from 
a central system. A retailer might offer different prices for different channels, 
based on the demand and customer behavior. 

Transact 

Various delivery and payment options are made available in a cross channel 
solution. A customer can buy or reserve merchandise online and then can 
pick up or pay in store. Customers can also choose to pay online and have the 
order delivered either to the store or to home. While shopping in store, a 
customer can choose to have the order delivered to home. They can choose 
to pay online or in store using various payment methods. 

Post-transaction (service and support) 

Order status is available online and in store. The customer can be informed 
through SMS or e-mail, as per that customer’s preference. The customer can 
choose to modify an order online or in store, which is done seamlessly for 
them. Products bought online can be returned in store or from home, thus 
providing complete comfort and flexibility to the customer. In addition, the 
customer’s purchase history is always accessible online or in store for 
reference. 

Call center support 

All customer and order information is available at the call center. Thus, 
customers can contact the call center at any time to obtain information about 
order or return status. 
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1.2.1 Cross-channel evolution 


Cross-channel evolution has occurred as a natural evolution of IT technologies 
and standards. Table 1-1 provides a quick review of the phases that the industry 
has been taken to transition to a cross channel strategy. 


Table 1-1 Cross-channel evolution 


Phases 

Description 

Silo systems include channels for specific 
transactions, such as the following 
transactions: 

► Buy online and ship to home 

► Buy off the shelf items in store 

► Call a customer service 
representative (CSR) to purchase 

This phase includes the following main pains: 

► Retailers operate in siloed channels, resulting in 
conflicting metrics and goals, thus discouraging 
customers. For example, the in-store sales staff does 
not get credit for sales on the Web. 

► Processes and data are duplicated across channels and 
are inconsistent, which might lead to unhappy 
customers. Thus, master data (customer, product, 
vendor, and so forth) that supports and streamlines 
retailers’ operations and functionalities across channels 
is needed. 

► The siloed merchandising processes handcuff the 
company and contribute to long lead times, budget 
overruns, and regular supply and demand imbalances. 

Cooperation across channels provides 
communications and interfaces between 
applications such as the following 
applications: 

► Buy online and ship to store 

► Lookup store location 

With this phase, transactions are coordinated between Web, 
store, and call center. 

There are many point-to-point connections, or there might be 
Enterprise Application Integration (EAI) middleware that 
transforms messages using applications. 

On this phase, there is still a big impact to manage business 
needs, but there is little support for mobile deployment. 
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Phases 

Description 

Cross-channel retailing ties with 
previously siloed systems with an 
SOA-based approach. 

Companies use industry-standard 
reference models and enterprise 
architecture frameworks. 

This phase provides seamless integration 
for the customers where the company 
offers the following capabilities: 

► Buy online and pick up in store 

► Reserve online and pay or pick up in 
store 

► View store promotions and events 
online 

► Offer online and redeem in store 

► Buy online and return in store 

► Buy out-of-stock items in store and 
ship to home 

By taking advantage of multichannel solutions, a company 
can put in place a single customer interaction platform that 
provides a more consistent and more relevant experience for 
customers. This solution provides the following advantages: 

► Single view of customer data and metrics across 
channels, which aids in providing consistent data to 
customers (for example, credits) and provides better 
analysis of customer behavior. 

► Better targeted merchandising and marketing as a result 
of consistent and integrated customer behavior data. 

► Single inventory pool takes care of lead times, 
demand-supply imbalances, and reverse logistics across 
all operations (buybacks, return to vendor, customer 
returns, and so forth). 

► Use of mobile devices to integrate the company to 
customer’s world. 


1.2.2 The most popular cross channel shopping processes 

With multichannel integrated shopping solutions, retailers can focus on the 
integrated consumer retail experience. Retailers can differentiate their brand 
from competitors by taking advantage of a flexible and integrated process-based 
platform across marketing, selling, order capture, and fulfillment. This solution 
simplifies and transforms the shopping experience by making it easier for 
consumers to transact business across channels seamlessly. 

When looking for a logical model to work with cross channel solutions, IBM 
defines the following top cross channel processes: 

► Buy or reserve online, pick up or pay in store 

This process is the key process to bridge the online and in store shopping 
experience. You can achieve this process in multiple way (for example, 
point-to-point, messaging, or process) using an SOA-based approach. When 
developing an enterprise architecture, you can make a step-by-step plan that 
lets your company adopt a roadmap for integration that is aligned with this 
business process. You also can use new Commerce functions without 
modification, such as store locator, local inventory, and payments. 
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► Return or exchange items bought online to the store 

This process is an essential process for providing a complete cross channel 
solution. With this process, the IT business must be aligned, because there is 
an entire view of the consumer life cycle and IBM WebSphere Commerce V7 
that is built on returning or exchanging items bought online in the store. This 
feature increases customer return and loyalty with a good shopping 
experience. 

► Buy merchandise in store when an item is out-of-stock 

This process is about saving the sale when items are not available. 
On-demand companies need to use the right tools to offer the best shopping 
experience for consumers. Your cross channel solution must provide a full 
view into the entire inventory, throughout the enterprise and other stores, to 
let the IT infrastructure be the framework for composite applications that do 
the supporting work. 

► Offer and purchase additional items in store (targeted marketing) 

This process helps you to understand the customer and, thus, to increase the 
size of the sale as well as build brand loyalty. This process is an important 
feature in WebSphere Commerce, because it uses granular customer 
information, including channel events, to purchase items in a nearby store. 
The customer can receive targeted marketing through SMS and social 
commerce. 


1.3 The IBM solution 

Companies ship products world wide. This global distribution process involves 
manufacturers, suppliers, and distributors. Thus, there is a real need to 
seamlessly integrate information through both internal and external networks. 
IBM provides a supporting infrastructure and best practices, based on industry 
assets, that you can use to build a robust platform that manages an efficient 
integration and a useful cross channel solution. IBM offers a wide breadth of 
products to satisfy the on-demand business requirements: 

► Application infrastructure 

► Application and process integration 

► Portal, commerce 

► Collaboration 

► Messaging 

► Database integration 

► Enterprise security 

► Pervasive computing 

► End-to-end application development 
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WebSphere Commerce takes advantage of and integrates with these middleware 
products and technologies to deliver and amplify their value within an 
e-commerce and multichannel context. 

1.3.1 IBM Retail Integration Framework 

IBM Retail Integration Framework is a structure that delivers integration focused 
design and software assets to help make complex integration simpler and faster 
to retailers. By adopting the IBM Retail Integration Framework strategy, you can 
take advantage of a enterprise architecture and an SOA-based approach, which 
enable you to use business process management methods to view the IT 
environment as linked, repeatable business tasks or services. With IBM Retail 
Integration Framework, you can make your IT environment more responsive to 
the needs of the business. 

IBM Retail Integration Framework is a growing set of pre-built application 
integration assets that address the following types of high-value retail domains: 

► Managing master data for merchandising and supply chain: A platform to 
maintain uniform and consistent master data of your main elements, such as 
products, locations, and vendors. 

► Cross-channel selling: Enable a cross channel retailing solution that allows 
you to expose retail capabilities to your customers across multiple 
touchpoints. 

► Supply chain visibility: Take advantage of seamless visibility into supply chain 
events across channels to manage those events and to help reduce operating 
costs. 

► Managing master data for customers: Implement a platform that helps you 
maintain uniform and consistent master data regarding customers. 

► Integrated retail analytics: Inject customer insights into the retail processes 
through integrated retail analytics, which helps to make insights actionable. 

► Total store solutions: Integrate and improve management in the store 
environment while accelerating the introduction of innovative solution. 

1.3.2 WebSphere Commerce integration capabilities 

WebSphere Commerce lets a company deliver a continuous and personalized 
customer experience, regardless of the channel in which a customer participates. 
It lets the company manage different scenarios such as business-to-business, 
business-to-consumer, and other specialized products to integrate and improve 
the line of business. Every aspect of WebSphere Commerce is designed to take 
advantage of the appropriate components of the IBM middleware platform. 
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Rather than developing its own solutions for the services and capabilities that are 
needed to support a cross channel commerce environment (such as database, 
portal, integration, security, and so forth), WebSphere Commerce takes 
advantage of the leading products within the IBM middleware portfolio to provide 
those capabilities. WebSphere Commerce is pre-integrated with these 
middleware products and includes the appropriate components, complete with 
integrated installation, configuration, and operations. 

In addition, WebSphere Commerce provides accelerators that make these 
components relevant and useful within a commerce environment. For example, 
WebSphere Commerce includes pre-integrations, reference applications, 
adaptors, and tools to accelerate integration using IBM WebSphere Business 
Integration components. 

WebSphere Commerce takes advantage of the IBM middleware platform (key 
components of which are integrated and ship with the product) to enable and 
accelerate the broadest, most encompassing range of integration capabilities on 
the market. 
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Figure 1-3 outlines the WebSphere Commerce cross channel product strategy. 



| Personalization | | Community | 

[ Inventory Visibility | 



Figure 1-3 WebSphere Commerce cross channel product strategy 


The WebSphere Commerce cross-channel product strategy includes the 
following features: 

► Integrate customer-facing processes across touchpoints 
WebSphere Portal and Pervasive help WebSphere Commerce enable a 
consistent experience and universal access to the data and processes that 
reside in enterprise-wide systems, across all of the touchpoints that the 
company supports and for all of types of users with whom a company 
interacts (such as employees, customers, and partners). 

► Collaborate with employees, customers, and partners 
Lotus® products help WebSphere Commerce enable real-time 
communication and collaboration (for example, live help, team selling, 
collaborative learning, and instant messaging) between and among 
employees, customers, and partners. 
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► Create a single, consolidated view of data and analytics 

DB2® helps WebSphere Commerce enable companies to take advantage of 
all of the various sources that store and track data and content about 
customers, products, orders, and so forth to deliver a single, consistent view 
of the customer to the company, as well as a single view of the company to 
the customer. 

► Integrate with back-end and existing systems and connect to partners and 
suppliers 

WebSphere Business Integration products enable a range of integration 
options, whether a company needs simply point-to-point integration with a 
back-end system or more sophisticated process modeling and a complete 
demand-to-delivery integrated environment. In a demand-to-delivery 
environment, all business processes are linked horizontally and vertically 
across the value chain. 

► Ensure the security and performance of the integrated environment 
IBM Tivoli® products manage the security and monitor and analyze 
performance of the integrated environment. 

► Take advantage of open standards for maximum flexibility in integration 
Rational® products, industry-standard development environment and tools, 
Web Services, and adherence to open standards and protocols enable 
WebSphere Commerce to be deployed quickly and adapted to meet unique 
and changing needs and opportunities. In addition, these resources ensure 
that you can replace the IBM components of the system by custom or 
third-party add-ons. 

► Integrate with store environments 

WebSphere Remote Server gives retailers components to define a robust 
infrastructure with an SOA approach using IBM Retail Integration Framework 
with your enterprise architecture model. 


Building Multichannel Applications with WebSphere Commerce 



1.3.3 SOA for cross-channel integration 


WebSphere Commerce fits into the IBM SOA Foundation Architecture using 
services components to build a cross channel solution. Figure 1-4 gives an 
overview of SOA Logical Model to use with WebSphere Commerce solutions. 



Figure 1-4 SOA for cross channel integration 

Using SOA with WebSphere Commerce helps simplify integration between 
business processes and applications using standardized suggested components 
from retail industry models such as the SOA blueprint from Association for Retail 
Technology Standards (ARTS), IBM Retail Integration Framework, and 
Enterprise Architecture Frameworks. 
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For a specific scenario you must identify, model, and compare the following key 
assets with the previous reference frameworks: 

► Key business processes 

► Key applications 

► Key roles and business units 

► Key information 

► Key channels 

Then, you can follow an SOA-based approach using a top down or bottom up 
methodology, for example, using service-oriented modelling and architecture 
(SOMA) methodology to search for the following information: 

► Specific common tasks called services 

► Data integrity, quality, and completeness 

► General business rules 

► Business and IT events that you must measure 

Finally, you can use WebSphere Commerce to define the following domain 
assets: 

► A common model for product, customer, inventory, and orders to expose them 
as data services 

► Common functionalities across channel such as Payments, Shipping and 
Receiving, and Geo Services 

► Common scenarios using best practices that help to align IT with business 
objectives 


1.4 Cross-channel configurations 

This section describes how to integrate the following scenarios and three sample 
configurations to build a cross channel configuration using WebSphere 
Commerce: 

► Buy or reserve online, pick up and pay in store 

► Return or exchange in-store items bought online 

► Buy in store when out-of-stock 

► Offer and purchase additional items in store (targeted marketing) 
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Table 1-2 lists the three sample configurations. 


Table 1-2 Cross-channel configurations 


Configuration 

Main WebSphere Commerce feature 

WebSphere Commerce and DOM 

► Store Locator 

► Cross-channel inventory visibility and allocation 

► Order sourcing and fulfillment 

WebSphere Commerce and BPM 

► Dynamic business modeling 

► Configurable business rules 

► Business Activity Monitoring (BAM) 

WebSphere Commerce and Store 

► Point-of-Sale (POS) integration 

► Endless aisles kiosks and mobile devices 

► Cross-channel marketing and promotion 


Figure 1-5 shows how the scenarios and configurations relate to each other. 



This book focuses on WebSphere Commerce with distributed order management 
(referred to as DOM throughout this book) and the mobile solution as the first 
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natural step on a roadmap to adopt a cross channel strategy. The goal is to build 
a continual state of business and IT alignment through a series of projects that 
support the highest-impact business scenarios for cross channel selling. You 
must plan carefully before moving to these scenarios. It is critical to answer the 
following questions: 

► What business cross channel solution projects are implemented and in what 
sequence? 

► What channels do we need to implement? 

► What features will a channel deliver? 

► Who can use this channel? 

► Where to source the service or channel? 

► How to manage the channel for performance and services levels? 

You have a complete platform to deliver value using WebSphere Commerce 
features for cross channel solutions. We describe these features in the sections 
that follow. 


1.4.1 WebSphere Commerce and DOM 

In an enterprise where orders are managed by a dedicated back-end system, 
WebSphere Commerce offers the ability to integrate seamlessly with the order 
management system using SOA, which provides an integrated e-business 
solution that encompasses the entire order life cycle. In the integrated solution, 
WebSphere Commerce can provide rich front-ends for the sales channels, as 
well as robust functionalities in marketing, merchandising, personalization, order 
capture, and payment. In addition, the order management system can provide 
the back-end inventory and order management capabilities, plus integration with 
fulfillment and supplier networks as well as external services. 
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Figure 1-6 shows the high-level view of the integrated solution from a business 
perspective. 
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Figure 1-6 WebSphere Commerce integrated solution 


Solution 

WebSphere Commerce and DOM integration provides the following features as 

illustrated in the Figure 1-7 on page 20: 

► Integrated business processes to support common customer usage 
scenarios, including cross channel inventory visibility; buy online, ship to, and 
pick up in store; and buy-online and return in store 

► Open services interfaces and message flows for order transfers and updates, 
payment, and customer and inventory data over enterprise service bus (ESB) 
and SOA Foundation components 

► Reference implementation that connects WebSphere Commerce with the 
DOM system (for example, Manhattan Associates, SAP) 
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Figure 1-7 DOM cycle 


Buy online, pick up in store is one of the scenarios on which we focus in this 
book. Most cross channel shoppers use the in-store pick up service because 
they do not want to pay for shipping or wait for the items to be delivered. When 
customers pick up an order in the store, they might also buy additional items, 
which increases the overall revenue. 

To enable the buy online, pick up in store scenario, we use the following new and 
enhanced capabilities in WebSphere Commerce: 

► Stock Locator, which allows shoppers to first look up in-store inventory 
availability information for any physical stores based on address and store 
attributes. DOM has visibility to inventory across stores and channels. 

► Enhanced WebSphere Commerce checkout to capture not just the regular 
Web orders but also orders with the in-store pickup option. The 
enhancements are not limited only to the Web channel. 

► The in-store fulfillment component to provide the fulfillment workflow for store 
associates to handle picking and packing these in-store pick up orders and to 
notify the shopper when the item is ready for pick up. WebSphere Commerce 
receives notifications for any status changes of the in-store pick up orders 
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from the in-store fulfillment component. Shoppers can also access real-time 
order status updates through WebSphere Commerce. 

Example flow for buy online, pick up in store 

Figure 1-8 illustrates the WebSphere Commerce and DOM integration flow for 
the buy online, pick up in store scenario (referred to as BOPIS in this book). 


Scenario: Buy online, pick up in store 



Figure 1-8 Buy online, pick up in store (BOPIS) flow 


The BOPIS process works as follows: 

1 . A shopper browses the product pages and selects the product. 

2. The shopper searches for and locates the store at which to pick up the 
product. 

3. Commerce verifies its inventory cache for the inventory level of the product in 
the fulfillment center or centers. If the information is not cached in WebSphere 
Commerce, it calls DOM for the information. 

4. The Commerce client user interface calls WebSphere Commerce to prepare 
the order for checkout. Then, Commerce calls DOM to reserve the inventory 
and to obtain the estimated ship date. 
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5. The WebSphere Commerce client user interface calls WebSphere Commerce 
to the submit order. WebSphere Commerce transfers the order to DOM. 
Depending on the configuration, WebSphere Commerce either transfers the 
order to DOM right away or waits until the payment is authorized. 

6. Commerce sends an e-mail notification to CSR for the pick-up request. 

7. DOM fulfills the order to the store. 

8. WebSphere Commerce sends an e-mail notification to customer for pickup. 

9. WebSphere Commerce pulls the order status from DOM. 

1.4.2 WebSphere Commerce and BPM 

Designed to transcend system, channels, and organizational boundaries, SOA 
can accelerate the speed and effectiveness of information sharing and process 
automation. A level of integration, coordination, and collaboration can also show 
positive effects throughout the value chain. 

Using WebSphere Commerce and BPM together provides the following benefits: 

► Increases overall business visibility and effectiveness throughout the entire 
value chain 

► Increases customer satisfaction throughout all channels and touchpoints 

Cross-channel scenario 

As an example of using WebSphere Commerce with BPM, we describe how the 
Point-of-Sale (POS) solution retrieves tasks on a business process and how 
WebSphere Commerce tasks are pulled on an on-demand basis to the store. 
The POS solution using the WebSphere Remote Server infrastructure is 
connected to the store data center where WebSphere Process Server intercepts 
messages to determine the next action. In this example, the Association for 
Retail Technology Standards (ARTS) is coming from the store. The WebSphere 
Remote Server Central Site is using Web Services to connect with WebSphere 
Commerce. 

Alternatively, an order is captured by a channel on WebSphere Commerce, and it 
can be pulled on demand to WebSphere Remote Server Central Site. 
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Figure 1-9 shows the IT infrastructure that we used to build this configuration. 
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Figure 1-9 Using WebSphere Commerce and BPM together 
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1.4.3 WebSphere Commerce on store environments 

Using WebSphere Commerce on store environments has the following benefits: 

► Single view of customers and orders throughout all channel 

► Seamless customer shopping experience throughout channels 

► Cross-channel marketing and promotion through a CSR interface and in-store 
kiosks 

Solution 

Using the same approach that we used with the WebSphere Commerce and 
BPM scenario, we use a Retail Reference Model, IBM Retail Integration 
Framework, and an Enterprise Architecture Framework. Using a Retail 
Reference Model on a retail environment, you have the following scenarios: 

► Store 

► Distribution Center 

► Central 

Each scenario has its own services or tasks that must be accomplished, and 
those services are located as business application services. 

On a logical model, you have a unique data model that uses a Retail Industry 
Standard such as ARTS. We have a domain that uses data services with master 
data management recommendations for product, customer, inventory, orders, 
and other elements of a cross channel solution environment. 

IBM Retail Integration Framework uses these elements with POS integration. 
The main integration components for this SOA approach are WebSphere 
Enterprise Service Bus and WebSphere MQ. 
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Figure 1-10 illustrates this scenario using WebSphere Commerce throughout the 
value chain, including store integration processes. 



Figure 1-10 WebSphere Commerce throughout value chain including store processes 


Table 1-3 lists the tools that you can use. 


Table 1-3 WebSphere Commerce and store main components 


Tool 

Purpose 

WebSphere Remote Server 

A collection of IBM middleware products that is intended to 
be a base software stack for running Web applications 
within a store 

WebSphere Enterprise Service Bus or 
WebSphere Message Broker 

A software component which provides fundamental services 
for complex architectures using event-driven and 
standard-based-messaging-engine 
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Cross-channel scenario 

We use open services interfaces and message flows for order transfer from 
WebSphere Commerce to POS applications through ARTS Remote Transaction 
Interface (RTI). POS Solution using WebSphere Remote Server infrastructure is 
connected to the store data center where ESB or MQ Broker intercept messages 
to dispatch them to WebSphere Commerce. Commands are used to implement 
basic functionality of WebSphere Process Server. 

Alternatively, an order is captured by a channel on WebSphere Commerce, and it 
can be pulled by the ESB or MQ Broker to dispatch it to WebSphere Remote 
Server Central Site. 
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Figure 1-11 shows IT infrastructure to build this configuration. 
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Figure 1-11 WebSphere Commerce on a store environment 
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1.5 Summary 


WebSphere Commerce provides the basis to build a robust cross channel 
solution with expanded multichannel and customer centric features to deliver rich 
and contextual experience, including community interaction. 
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IBM WebSphere Commerce 
V7 features 

This chapter describes the latest features and techniques of IBM WebSphere 
Commerce V7 and reviews the main features of IBM WebSphere Commerce V6 
Feature Enhancement Pack 5. 

The new and enhanced features in IBM WebSphere Commerce V7 are 
structured into general categories areas, which we discuss in the following 
topics: 

► Enhanced Madisons Starter Store 

► Social Commerce 

► Marketing improvements 

► Management Center enhancements 

► Utilities 

► Stack update 


© Copyright IBM Corp. 2010. All rights reserved. 
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2.1 Enhanced Madisons Starter Store 


In WebSphere Commerce V7, the Madisons Starter Store Web 2.0 
business-to-consumer store, introduced in IBM WebSphere Commerce V6 
Feature Enhancement Pack 2, is enhanced with new features and a general 
technology update. Furthermore, WebSphere Commerce V7 introduces a new 
business-to-business starter store, named Elite. 

2.1 .1 Madisons Starter Store 

The first version of the Madisons Starter Store B2C store, highlighting rich 
Internet application (RIA) features, was introduced in Feature Enhancement Pack 
2 of IBM WebSphere Commerce V6. Madisons Starter Store was enhanced with 
additional features in Feature Enhancement Pack 5 and is now further amended 
in IBM WebSphere Commerce V7. 


Note: In addition to the specific feature and technical enhancements 
mentioned in this section, Madisons Starter Store is now a standard starter 
store and replaces ConsumerDirect as the primary starter store for use when 
developing new business-to-consumer stores. 


In this section, we discuss the enhancements in the Madisons Starter Store that 
ships with IBM WebSphere Commerce V7, along with key enhancements from 
IBM WebSphere Commerce V6 Feature Enhancement Pack 5. 

Buy online, pick up in store 

The ability for shoppers to elect to pick up products in a brick-and-mortar store, 
rather than having the products shipped to their home or office, was introduced in 
IBM WebSphere Commerce V6 Feature Enhancement Pack 5. To use the buy 
online, pick up in store feature, referred to as BOPIS in this book, you need to 
enable the distributed order management (referred to as DOM throughout this 
book) functionality and provide a third-party inventory system, such as 
Manhattan Associates, to provide inventory information for the brick-and-mortar 
store to IBM WebSphere Commerce. 

IBM WebSphere Commerce V7 enhances this model by allowing customers to 
use the built-in available to promise (ATP) or non-ATP inventory models to handle 
the inventory for the brick-and-mortar stores. As such, if customers want to use 
BOPIS but do not want to use an external inventory system, they can do this in 
IBM WebSphere Commerce V7. 
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The ability for shoppers to buy online and pick up the products in a store brings 
many benefits to both shoppers and merchants. 

For shoppers, the main benefits include the ability to get the products 
immediately, rather than wait for the products to be picked, packed, and shipped, 
as well as the chance to inspect the product and return or exchange the products 
immediately if the product is not suitable. These advantages help increase 
customer confidence, especially for first-time shoppers. 

For merchants, the main benefit is that it brings the customers into the physical 
store, increasing the possibility that the shopper buys extra products, for 
example, as the result of an impulse purchase. 

Stock Locator 

Introduced in IBM WebSphere Commerce V6 Feature Enhancement Pack 5 and 
enhanced in IBM WebSphere Commerce V7, the Madisons Starter Store Stock 
Locator allows customers to verify the online inventory status of a given product 
as well as to check the product’s inventory status in any number of 
brick-and-mortar stores. 

A shopper can keep a personalized list of stores that is reused whenever the 
shopper requests the inventory status of a product in a physical store. 

As with the BOPIS feature, the shopper’s visibility to the in-store availability of a 
product increases the chance that the shopper will visit a physical store with the 
associated up-sell potential. 

Store Locator 

The Store Locator allows shoppers the ability to search for brick-and-mortar 
stores within a specified geographical location, such as a city or zip code. The 
resulting list of stores shows the address and phone number of each store, 
providing the ability for shoppers to contact a given store directly. Furthermore, 
the store list also provides a quick way for shoppers to add physical stores to the 
personal store list, which is then used by the BOPIS and Stock Locator features. 

DOM 

While not strictly a Madisons Starter Store feature, the DOM integration 
capability that was introduced with IBM WebSphere Commerce V6 Feature 
Enhancement Pack 5 enables the aforementioned Stock Locator and BOPIS 
functions, warranting its mention here. The DOM feature provides exposure for 
IBM WebSphere Commerce to the inventory levels on a large number of 
inventory locations, typically brick-and-mortar stores, without having to replicate 
this information within the IBM WebSphere Commerce inventory tables. For more 
information about DOM and a sample integration scenario using IBM WebSphere 
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Message Broker, see Chapter 3, “Distributed order management integration” on 
page 77. 

Improvements in the use of RIA features 

The first version of the Madisons Starter Store in IBM WebSphere Commerce V6 
Feature Enhancement Pack 2 introduced many RIA features, such as drag, 
add-to-cart without full screen refresh, and so forth. IBM WebSphere Commerce 
V7 improves several of these features: 

► Removal of the automatic product Quick Info pop-up panels 

In previous versions of the Madisons Starter Store, the product Quick Info 
panel opened automatically when the shopper moved the mouse pointer over 
a product thumbnail image on the category pages. This function had the 
tendency to impede the shopping flow and was considered intrusive to 
shoppers. 

Now, in IBM WebSphere Commerce V7, when the shopper moves the mouse 
pointer over a product thumbnail image, only a small button displays, as 
shown in Figure 2-1 . The product Quick Info view opens only if the shopper 
actively clicks this button. 
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Progress indicators 

A usability issue that occurs when adding RIA functionality to a Web site is 
the difficulty of users to understand the progress of asynchronous actions. 
This issue is especially true for longer-running actions, such as adding 
products to the shopping cart. 

To address this concern, the updated Madisons Starter Store introduces 
progress indicators for asynchronous actions. The indicator, the ubiquitous 
rotating circle ball animation, displays only when the shopper initiates an 
asynchronous action, as shown in Figure 2-2. 



Figure 2-2 The progress indicator that displays when clicking Add to Cart 


Improved fast finder 

The performance as well as the positioning of the product fast finder is 
improved in the IBM WebSphere Commerce V7 version of the Madisons 
Starter Store. In addition to the performance improvements inherent in the 
technology update (refer to “Dojo improvements” on page 38 for more 
information), the fast finder is optimized to handle very large categories. 
Instead of loading all products for the entire category during the initial page 
load, the fast finder loads only the first page of products and loads the 
remaining products in the background. 
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Figure 2-3 shows the product fast finder results. 



Easier use of Shopping Cart, Personal Wish List, and Product 
Compare 

In previous versions of the Madisons Starter Store, the accordion widget was 
used to implement a combined Shopping Cart, Personal Wish List, and Product 
Compare list. While this feature provided easy access to the contents, it took up 
a large amount of screen real estate. Furthermore, when shoppers attempted to 
use the drag functionality, the accordion compartments opened and closed in an 
almost uncontrollable manner, causing usability issues. 
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In IBM WebSphere Commerce V7, the Madisons Starter Store separates these 
three functions. The Shopping Cart is represented by an expandable mini 
shopping cart as shown in Figure 2-4. 



Figure 2-4 The mini shopping cart with two items in the cart 

The Personal Wish List function is rolled back to the ConsumerDirect 
functionality in that the Personal Wish List is accessible only as a full-page 
function, as shown in Figure 2-5. The Personal Wish List feature is linked to from 
the footer of all pages in Madisons Starter Store. 


Personal Wish List 


Displaying products 1 - 3 of 3 


mil 

— I 

Sharpson SmartBrew Coffee 
$14.99 
Add to Cart 

$54.99 

Add to Cart 

$2.99 

Add to Cart 
Remove 

Displaying products 1 - 3 of 3 

Figure 2-5 The Personal Wish List feature in Madisons Starter Store 
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The Product Compare area is located below the mini shopping cart as a fixed 
sized area that is always visible on the category and product pages, as shown in 
Figure 2-6. 



Figure 2-6 The Product Compare area below the mini shopping cart 

In-line editing of items in the Shopping Cart 

In IBM WebSphere Commerce V7, the Madisons Starter Store introduces the 
ability for shoppers to modify product attributes in-place in the Shopping Cart. 
This function allows shoppers to change defining attributes, such as the size or 
color of an item, without having to remove the current SKU and add the new SKU 
with other attributes. 

Coupon wallet 

In IBM WebSphere Commerce V7, the Madisons Starter Store introduces the 
concept of a coupon wallet. This function provides registered shoppers with the 
ability to view the coupons for which they qualify and to apply for coupons directly 
from the wallet upon checkout, without having to remember and manually enter 
coupon codes. 

Shopping Cart pagination 

Pagination is added to the Shopping Cart. This feature is useful for limiting the 
size of the page when the shopping cart list of items is very large, which is 
typically the case for grocery merchants, where shopping carts with many items 
are commonplace. With the pagination feature, shoppers can change the page 
size using simple JavaServer Pages (JSP) customization. The default size is 20 
items. 
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New pay in store payment method 

A new payment method that allows customers to pay in the store rather than 
giving payment information online is now available. This method is available for 
shoppers who elect to buy online and to pick up the products in a physical store. 

In addition to simplifying the order process, the shopper does not need to enter 
credit card information online with this feature. This feature is also beneficial in 
markets where cash and check payments are the predominant payment 
methods. It also supports merchants who require that payment capture is 
handled through in-store terminals. 

Improved accessibility 

In IBM WebSphere Commerce V7, the Madisons Starter Store includes several 
changes to the underlying HTML that can increase the accessibility of the site: 

► Improved screen reader support 

The W3C Web Accessibility Initiative (WAI) traditionally has discouraged all 
use of JavaScript in accessible Web sites (c.f. Checkpoint 6.1 of the Web 
Content Accessibility Guidelines (WCAG) 1.0). 

In recognition that this guideline is not sustainable with the proliferation of RIA 
Web sites, W3C WAI published th e Accessible RIA Suite (WAI-ARIA). The 
current version of this document at the time of writing is Working Draft 4. 
WAI-ARIA prescribes methods for annotating the HTML that is used in an RIA 
such that the resulting Web site is accessible to people with disabilities. 

The use of Dojo widgets is changed to conform to WAI-ARIA. Specifically, all 
refresh areas are amended with WAI-ARIA defined attributes. These 
attributes provide information to screen readers about the role and 
importance of each area. 

All refresh areas within Madisons Starter Store are defined as live regions, 
which is the WAI-ARIA term for dynamically refreshed areas of a Web page. 
These regions are defines as being polite, which means that the shopper is 
informed about changes of the content in that area only when the shopper is 
done with the current task. 

► Use of semantic HTML 

The starter stores of previous versions of IBM WebSphere Commerce were 
heavily dependant on using tables for layout. The Madisons Starter Store that 
ships with IBM WebSphere Commerce V7 uses Cascading Style Sheet 
(CSS) technology with HTML di v tags instead, which results in JavaServer 
Pages (JSPs) that are easier to customize and maintain and provides a better 
separation of content from layout. 
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Store archives for extended sites models 

In addition to the basic composite store archive for publishing a stand-alone 
Madisons Starter Store, IBM WebSphere Commerce V7 also delivers storefront 
asset stores for the extended sites models. The storefront asset stores allow 
store developers to publish a customer-facing store based on the business logic 
and views of the Madisons Starter Store B2C store. 

Dojo improvements 

The Dojo Toolkit, which is used in the Madisons Starter Store, includes a number 
of technical changes that provide for RIA features: 

► Previous versions of the Madisons Starter Store used the Dojo Toolkit Version 
0.4.1 . The Madisons starter store now uses the Dojo Toolkit Version 1 .3.1 , 
which includes a number of functional and performance improvements. 

► The Madisons Starter Store archive now includes the Dojo Toolkit, which 
eliminates the need to download the toolkit from the Dojo Web site. 

► The JavaScript library used in Madisons Starter Store is customized to 
contain only the functions that are needed within the Madisons Starter Store, 
which results in a substantially reduced download size. 

► The following new Dojo widgets are added to the IBM WebSphere Commerce 
specific libraries: 

- WCDialog 

This widget is a customized version of the standard Dojo di jit. Dialog, 
which is used in the Madisons Starter Store to display the contents of the 
shopping cart when the shopper moves the mouse pointer over the mini 
shopping cart area, as shown in Figure 2-7. 



Figure 2-7 The WCDialog widget 
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- WCDropDownButton 

This widget implements a drop-down type menu where the menu items 
are hidden until the shopper moves the mouse pointer over the menu 
name. WCDropDownButton uses the WCMenu widget to display the 
drop-down menu. Figure 2-8 illustrates how the WCDropDownButton 
widget is used in Madisons Starter Store to generate the top-level 
category buttons in the header of every page. 

- WCMenu 

This widget is an extension of the standard di jit. Menu widget, providing 
framework support for menus such as the top categories on the home 
page of the Madisons Starter Store. Figure 2-8 shows the use of WCMenu 
in the Madisons Starter Store to create the submenu with the second-level 
categories whenever the shopper moves the mouse pointer over one of 
the top-level categories in the header. Each of the second-level categories 
(Cooking Oils, Frying Pans, Pots, Accessories, and Coffee Makers in 
Figure 2-8) is implemented as a di jit.MenuItem instance. 



The Dojo parser allows manually specified IDs of DOM nodes. 

The standard behavior for Dojo upon loading a page is for the parser to 
traverse the entire DOM to search for embedded Dojo widgets. This process 
can be time consuming and, thus, can result in a noticeable delay from the 
time a page is initially rendered by the shopper’s browser until any Dojo 
widgets finish rendering and become responsive. 

To address this issue, the Madisons Starter Store in IBM WebSphere 
Commerce V7 uses a different approach in which the page developers 
manually specify the IDs of the DOM nodes that contain Dojo widgets to the 
Dojo parser. This change results in a much more efficient page initialization 
process and, thus, a faster response time for shoppers. 
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New Change Flow options 

The Change Flow pages within the WebSphere Commerce Accelerator for the 
Madisons Starter Store in IBM WebSphere Commerce V 7 are amended with 
functions to switch on and off specific RIA features within the customer-facing 
store. The use of RIA features in the following areas can be controlled through 
Change Flow pages, as shown in Figure 2-9: 

► Product Quick Info 


This switch controls whether the shopper can display product details in a 
pop-up panel directly from any product thumbnail image, as described in 
“Improvements in the use of RIA features” on page 32. 

► Ajax add to Shopping Cart 

This feature controls whether Ajax is to be used for adding products to the 
Shopping Cart. If this flow feature is enabled, then the shopper does not leave 
the current page if a product is added to the Shopping Cart. 

If disabled, the functionality is similar to the functionality within the 
ConsumerDirect starter store, whereby adding a product to the Shopping Cart 
is a synchronous action that results in displaying the Shopping Cart page. 

► Ajax checkout 

This flow feature determines whether the changes in the Shopping Cart are 
applied asynchronously as they are made or whether the shopper has to click 
a button after making a change in order to apply the changes. 

► Ajax My Account 

This flow feature determines whether the changes on the My Account pages 
are applied asynchronously as they are made or whether the shopper has to 
click a button after making a change in order to apply the changes. 

► Product drag 

This flow feature controls whether the shopper can add products to the 
Shopping Cart by dragging the product thumbnail images to the mini 
shopping cart. If enabled, shoppers can also drag products to the compare 
area in a similar way. 


Note: This feature is disabled automatically if both the Compare zone 
(under Catalog) and mini shopping cart (under Orders) flow features are 
disabled. 
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Customer Interactions 

Select the Web 2.0 features that customers can use in your store: 

Display product details in the Product Quick Info pop-up window. 

17 Product Quick Info 

Add items to the shopping cart without leaving the current page. 

17 AJAX add to shopping cart 

Automatically apply changes made to the shopping cart. 

17 AJAX checkout 

Automatically apply changes made on the My Account page. 

17 AJAX My Account 

Add items to the shopping cart, or compare zone, by using the mouse. 

Note: If the mini shopping cart and compare zone features are disabled; then this 

17 Product drag-and-drop 
Figure 2-9 Web 2. 0 Change Flow features 

New <wcf:url> tag 

The <wcf :url> tag generates links on the shopping pages and is added to the 
wcf tag library. This tag replaces the <c : url > tag from the JavaServer Pages 
Standard Tag Library (JSTL) and reduces the amount of effort that is needed to 
implement search engine optimization (SEO) URLs in the store. Example 2-1 
shows an example of the use of the standard JSTL <c : url > tag. 

Example 2- 1 Use of the standard <c:url> JSTL tag 

<c:url var=”myllRL” value=”CategoryOnlyResultDisplayView”> 

<c:param name=”storeId” val ue=”${WCParam.storeId}” /> 

<c:param name=”l angld” val ue=”${ langld}’* /> 

<c:param name=”catal ogld” value=”${WCParam.catalogId}” /> 

<c:param name=”categoryId” val ue=”${WCParam.categoryId}” /> 

</c:url> 
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Example 2-2 shows how to change the code from Example 2-1 to use the 
specialized <wcf :url> tag. The changes are highlighted in bold. 

Example 2-2 Use of the specialized IBM WebSphere Commerce <wcf:url> tag 

<wcf:url var=”myURL” value=”CategoryOnlyResultDisplayView”> 
<wcf:param name=”storeId” val ue=”${WCParam.storeId}” /> 
<wcf:param name=”l angld” value=”${langld}” /> 

<wcf:param name=”catalogId” val ue=”${WCParam.catalogId}” /> 
<wcf:param name=”categoryId” val ue=”${WCParam.categoryId}” /> 
</wcf:url> 


Functionality between the JSTL <c : url > tag and the IBM WebSphere Commerce 
V7 <wcf :url> tag is different in the following ways: 

► The <wcf :url> tag generates the full path, including the protocol. For 
example, instead of generating the following path: 

Category0nlyDisplayView?storeId=10001&langId=-l&catalogId=10001&cate 

goryld=10001 

The <wcf :url> tag generates this path: 

http://www.redbooks.ibm.com/webapp/wcs/stores/servlet/CategoryOnlyDi 
splayView?storeId=10001&langId=-l&catalogId=10001&categoryId= 10001 

Note: This example assumes that the SEO URLMapper is not enabled. 

► If the SEO URLMapper is enabled, the <wcf :url> tag automatically generates 
a URL that matches the current rules that are defined in URLMapper. xml . The 
example in the previous bullet list item thus results in the following path: 
http://www.redbooks.ibm.com/webapp/wcs/stores/servlet/CategoryOnlyDi 
spl ay 1_10001_- 1_10001_10001 

► The <wcf :url> tag prefixes the URL automatically with the appropriate 
protocol, depending on the https setting in the struts configuration file, thus 
eliminating the necessity of a round trip to the server. Figure 2-10 shows a 
comparison between using the server to redirect to an SSL connection versus 
generating the links with the HTTPS protocol to begin with. As Figure 2-10 
illustrates, generating the links with the HTTPS protocol embedded saves a 
round trip for each request. 

Furthermore, if the page does not require SSL, the <wcf :url> tag prefixes the 
link using the Hypertext Transfer Protocol (HTTP) protocol, thereby switching 
back to the more efficient non-SSL HTTP protocol. 
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Figure 2-10 Comparison of using the server to redirect to SSL versus generating SSL links 


Increased use of services instead of data beans 

The coverage of component services is expanded in IBM WebSphere Commerce 
V7. As such, the use of the <wcf :getData> tag instead of the <wcbase:useBean> 
tag in the Madisons Starter Store starter store is increased as well. Example 2-3 
shows an example of retrieving order details using the <wcbase:useBean> tag. 

Example 2-3 Using the <wcbase:useBean> to retrieve order details with a data bean 
<wcbase:useBean 

cl assname=”com. ibm. commerce. order. beans. OrderDataBean” 

id=”orderBean” 

scope=”page”> 


<c:set property=”orderId” val ue=”${WCParam.orderId}” 
target=”${orderBean}” /> 

</wcbase:useBean> 


Example 2-4 shows how to implement the code from Example 2-3 using 
component services. 

Example 2-4 Using <wcf:getData> to retrieve order details through component services 
<wcf :getData 

ty pe=”bom .ibm. commerce . order . facade . datatypes . Orderly pe” 
var=”order” 

expressi onBui 1 der=”f i ndByOrder!d”> 
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<wcf:param name=”accessProfi 1 e” val ue=”IBM_Detai 1 s” /> 
<wcf:param name=”orderId” val ue=”${WCParam.orderId}” /> 

</wcf :getData> 


Comparing the code in Example 2-3 with that in Example 2-4 shows that the 
switch to using component services is not necessarily for simplicity of the code. 
Instead, the use of component service provides a better abstraction, allowing the 
component services to retrieve data in a way that can be more efficient for the 
task at hand. The move to using component services is a continuation of the 
service-oriented architecture (SOA) adoption within IBM WebSphere Commerce. 


Note: Although Example 2-3 and Example 2-4 show equivalent methods for 
retrieving data, there are areas in which using the <wcf :getData> tag is the 
only way to retrieve the data, for example for some of the precision marketing 
functions in IBM WebSphere Commerce V7. (For more information, refer to 
2.3.4, “Precision marketing” on page 65.) Some of the new capabilities within 
this area are not exposed as classic data beans and, thus, cannot be 
accessed using the <wcbase:useBean> tag. 


Using JavaScript for Ajax code directly in JSPs 

When the first Web 2.0 reference store was released in IBM WebSphere 
Commerce V6 Feature Enhancement Pack 2, it introduced a number of JSP 
tags. These tags simplified the generation of the required JavaScript for setting 
up Ajax services, render contexts and refresh controllers by generating the 
required JavaScript at run time. 

Although these JSP tags provided a convenient way to generate the required 
JavaScript for refresh controllers, they made it more cumbersome to change the 
underlying libraries or to add extra parameters to the JavaScript. Thus, the 
Madisons Starter Store JSPs in IBM WebSphere Commerce V7 use JavaScript 
directly in the JSPs for declaring these objects and areas. 

Table 2-1 compares the previous JSP tags to the new JavaScript declarations 
with a short description of what each tag does. 


Table 2- 1 Comparison of previous JSP tags to new Java Script declarations 


Feature Enhancement Pack 2 

IBM WebSphere Commerce V7 

Description 

wcf:declareService 

wc. service. declare 

Defines the endpoint for an 
asynchronous service call. 


44 Building Multichannel Applications with WebSphere Commerce 







Feature Enhancement Pack 2 

IBM WebSphere Commerce V7 

Description 

wcf :decl areRenderContext 

wc . servi ce . decl areContext 

Defines an area that can be 
refreshed as the result of an Ajax 
call. 

wcf :declareRefreshController 

wc . servi ce . decl areRef resh 
Controller 

Defines a controller that 
determines what to refresh when 
responses are returned from the 
server. 


Although JSP tags are available, do not use them, because they generate code 
that is compatible only with Dojo Version 0.4. Use the JavaScript declarations for 
new Ajax development. 

Additional languages 

In addition to the standard 10 group one languages, the Madisons Starter Store 
is translated to the following languages: 

► Polish (pl_PL) 

► Romanian (ro_RO) 

► Russian (ru_RU) 

For reference, the following are the 10 group one languages with the associated 
locale names: 

► French (fr_FR) 

► German (de_DE) 

► Italian (itJT) 

► Japanese (ja_JP) 

► Korean (ko_KR) 

► Portuguese (pt_BR) 

► Simplified Chinese (zh_CN) 

► Spanish (es_ES) 

► Traditional Chinese (zh_TW) 

► US English (enJJS) 
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Functions not included in the Madisons Starter Store 

The version of Madisons Starter Store that ships with IBM WebSphere 
Commerce V7 does not include the following functions: 

► Gift Center 

There is no Gift Center store archive for Madisons Starter Store, so you need 
to customize any gift registry functionality. 

► Customer Care 

Customer Care is the ability for shoppers to initiate a chat session with a 
customer service representative (CSR), and it allows the CSR to retrieve the 
shopper’s profile and the shopping cart information. 

The version of the Madisons Starter Store that ships does not support a 
Customer Care feature. If you require this feature, you need to customize the 
Madisons starter store. 

► Attribute dictionary 

The attribute dictionary is a concept that was introduced in IBM WebSphere 
Commerce V6 Feature Enhancement Pack 2. 

In the traditional attribute model in IBM WebSphere Commerce, attributes are 
defined on the product level, even for attributes that are seemingly identical, 
such as the color or size of different shirts in the catalog. 

The attribute dictionary allows for sharing common attributes across products. 
With the attribute dictionary, the catalog manager defines the color or size 
attributes and its values only once for the entire catalog and can simply 
assign those attributes to products for which the attributes apply. 

Although the attribute dictionary feature is available in IBM WebSphere 
Commerce V7, the Madisons Starter Store does not take advantage of the 
attribute dictionary. Thus, this feature is not supported in Madisons Starter 
Store. 

► Auctions 

Because Madisons Starter Store is a business-to-consumer store, auctions 
are not supported. 

► Request for Quote (RFQ) 

Because Madisons Starter Store is a business-to-consumer store, RFQ is not 
supported. 

2.1.2 Enhanced business-to-business starter store 

In addition to the traditional business-to-business starter stores, IBM WebSphere 
Commerce V7 includes a new enhanced starter store, called Elite. 
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Elite adds all of the RIA features from Madisons Starter Store to the advanced 
B2B direct starter store, such as drag, quick product information, direct editing in 
the shopping cart, product fast finder, and so forth, as well as some of the 
technical enhancements that are added to Madisons Starter Store in IBM 
WebSphere Commerce V7, such as semantic HTML, accessibility features, 
additional languages, and SEO optimized URLs. 

2.1.3 Madisons Mobile Starter Store add-on store archive 

Recognizing the growth in the mobile e-commerce market, IBM is delivering an 
add-on store archive, MadisonsMobile.sar, with IBM WebSphere Commerce V7 
to publish on top of the Madisons Starter Store. An add-on store archive is a 
store archive that does not have the assets that are necessary to create a 
complete store. Instead, the add-on store archive is intended to add capabilities 
to an existing store. The Gift Center store archives for IBM WebSphere 
Commerce V6 are examples of add-on store archives for the ConsumerDirect 
starter store. 

The MadisonsMobile.sar store archive adds mobile capabilities to the Madisons 
Starter Store, which we describe in the following sections. 

Mobile pages 

The main visible feature of the Madisons Mobile Starter Store add-on store 
archive is that it contains a set of pages that provide much of the existing 
Madisons Starter Store functionality, catered to the constraints of a mobile 
device. The major differences between the regular Madisons Starter Store pages 
and the Madisons Mobile Starter Store pages are that the mobile pages are 
designed to fit within the display of a Tier-1 Smartphone, for example a device 
with a display resolution of 240 by 320 pixels. Furthermore, the use of RIA 
features is minimized to better match the capabilities of mobile devices, such as 
the limits on JavaScript capabilities and on the size of documents that are sent to 
the device. 

Some pages are changed to reduce the amount of data that is necessary for 
shoppers to input in order to complete various tasks. For example, the number of 
fields for registration on the Madisons Mobile Starter Store store is reduced to 
the following fields, as shown in Figure 2-1 1 : 

► Logon ID 

► Password (and Verify Password) 

► First Name 

► Last Name 

► E-mail 
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Register 

To create an account please register 
below. All fields marked with an (*) 
are required. 

“Logon ID 


“Password (6 characters minimum 
with 1 numeric) 


“Verify Password 


First Name 

I ' I 




Figure 2-11 User registration form for Madisons Mobile Starter Store 

These reduced fields are in contrast to the following fields, which are required for 
a standard Madisons Starter Store registration process, as shown in Figure 2-12: 

► Logon ID 

► Password (and Verify password) 

► First Name 

► Last Name 

► Street address 

► City 

► Country/Region 

► State/Province 

► ZIP code/Postal code 

► E-mail 

► Phone number 

► Store specials option 

► Preferred language 

► Preferred currency 

► Gender 

► Birthday 

► Mobile Phone Number 

► Short Message Service (SMS) preferences 

► Remember Me preference 
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Finally, the pages shipped in the Madisons Mobile Starter Store store are tested 
to conform to W3C’s mobileOK Basic Tests 1 .0, which verify a subset of the W3C 
Mobile Web Best Practices 1.0 specification. For more information, refer to: 
http://www.w3 . org/TR/mobi 1 e-bp/ 

Mobile access keys 

As part of making the pages more accessible to mobile devices, access keys are 
set up for the functions listed in Table 2-2. These store-wide access keys are 
defined for quick access to some of the central functions. 

Table 2-2 Store-wide access keys for Madisons Mobile Starter Store 


Access Key 

Function 

1 

Home 

2 

Shopping Cart 

3 

Search 

4 

Product Comparison 

5 

Store Locator 

6 

Change Language/Currency 

7 

Personal Wish List 

8 

My Account 

9 

Contact Us 


SMS foundation support 

IBM WebSphere Commerce V7 adds support for SMS through integration with 
third-party gateways. The following new Java EE Connector Architecture (JCA) 
resource adapters ship with IBM WebSphere Commerce V7: 

► JCASMS-HTTP 

This resource adapter implements a simple HTTP-based SMS interface, used 
by many SMS gateway providers. The resource adapter accepts any number 
of name-value pairs, defining various aspects of the message, such as the 
recipient’s phone number and the message type, as well as protocol data, 
such as authentication keys and the target URL. 

The transport that is predefined to map to this resource adapter defines the 
most common subset of name-value pairs and provides the ability to amend 
this set with any number of extra parameters. 
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► JCASMS-WS 

This resource adapter implements part 4 of the Parlay X 3.0 specification. 
Part 4 defines the specifications for a Web Services based SMS gateway. As 
such, any merchant that has access to a Parlay X compliant SMS gateway 
can use the transport that is defined for this resource adapter to send text 
messages to mobile devices. 


Note: The transports and resource adapters for SMS messaging is strictly not 
part of the Madisons Mobile Starter Store. We describe it in this section, 
because the Madisons Mobile Starter Store is the store that is most likely to 
make use of these adapters. 

The SMS adapters and transports are part of the IBM WebSphere Commerce 
V7 foundation. 


For more details, refer to “Using SMS functionality for mobile marketing” on 
page 193. 

SMS order status updates 

One use of the SMS adapters described in “SMS foundation support” on page 50 
is for sending order status messages to a mobile device. This feature allows 
shoppers to get real-time order status information, which is useful if the shopper 
is not close to a personal computer. 

Functions not included in the Madisons Mobile Starter Store 

The following functions are omitted from the mobile pages on Madisons Mobile 
Starter Store compared to the regular Madisons Starter Store storefront: 

► Merchandising associations 

► Coupon wallet in My Account 

► Quick Checkout profile in My Account 

► Address Book in My Account 

► Checkout and Ship to Home or Office 

Note: Only the shipping options are not available in Madisons Mobile Starter 
Store. By using Madisons Mobile Starter Store, shoppers can still checkout 
through the buy online and pick up in store delivery option. Refer to 5.4, “Buy 
on mobile device and select shipping address” on page 221 for an example of 
adding shipping to the checkout pages for Madisons Mobile Starter Store. 


These functions are omitted mostly due to the limitations of the mobile device. 
For example, managing an address book is not as easy from a mobile device as 
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from a personal computer. There are no technical limitations to adding any of 
these features. 


2.2 Social Commerce 

Social Commerce is a term coined to describe the convergence of e-commerce 
with social networking on the Web. Merchants are investing in Social Commerce 
features for their e-commerce site to create and nurture the community around 
the brand and Web site. With the increase of use of social networks on the Web, 
creating a virtual community around the site communicates to the shoppers that 
the merchant respects shoppers’ opinions and helps solidify the brand loyalty. 

Versions of the Madisons starter store prior to IBM WebSphere Commerce V7 
were constrained to the RIA aspects of Web 2.0 and did not address the social 
aspects of e-commerce. With IBM WebSphere Commerce V7, however, the 
following Social Commerce features are incorporated into the product: 

► Sharing on social networks 

► Ratings and reviews 

► Product and category blogs 

► Photo and video galleries 

► Social profile 

We describe each of these features in the following sections. We also include a 
technical discussion regarding implementation details in 2.2.6, “Social 
Commerce integration” on page 58. 
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2.2.1 Sharing on social networks 


The simplest Social Commerce feature is the addition of shortcuts for users to 
share a given page (for example, a product or a category page) on a social 
network. Figure 2-13 shows an example of four social network sharing buttons. 



^0 Add to Compare 
t)Add to Wish List 



Check Store Availability 
Online Availability: 

Q Out of Stock 
In-Store Availability: 

Select Store 

Figure 2-13 Social network sharing buttons on a product page 

Figure 2-13 shows the following social network sharing buttons, listed 
left-to-right: 

► Digg 

Digg is a community site where users vote on Web pages that are submitted 
by other users. Many people use the highest ranked pages (determined by 
the number of diggs that a page receives) to get inspiration for visiting new 
sites. To visit this site, go to: 
http://www.digg.com/ 
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► Delicious 


Delicious provides public bookmark functionality. Users can add their own 
sites to their public profile, assign tags to each bookmark, and publish the 
bookmarks for other users to see. Other users can then choose to save any of 
those bookmarks in their own profile. 

The popularity of a bookmark is determined by the number of users who save 
a given bookmark. Delicious is another service that is used to get inspiration 
for visiting new sites. To visit this site, go to: 
http://www.del icious.com/ 

► Facebook 

Facebook is a popular social networking Web site. Facebook was rated the 
most popular social networking site in the world by complete.com in February 
2009, closely followed by MySpace. Clicking the Facebook icon allows the 
user to add a status update the current page or to send and view private 
messages on Facebook. To visit this site, go to: 
http://www.facebook.com/ 

► Google Bookmarks 

Google Bookmarks is a service similar to Delicious, with the notable 
difference that bookmarks stored with Google Bookmarks are not shared with 
other users. So, rather than providing a bookmark sharing service, Google 
Bookmarks allow users to store their bookmarks in a central location and, with 
a number of tools such as a Mozilla Firefox plug-in, the users can synchronize 
bookmarks with their browser’s bookmark list. To visit this site, go to: 

http://www.google.com/ 


2.2.2 Ratings and reviews 

Product ratings and reviews provide the ability for shoppers to share information 
about the quality and use of the individual products. Ironically, shoppers are more 
prone to trust the opinions of complete strangers than a trusted brand, as long as 
these complete strangers are thought to be independent on the merchant or 
brand owner. As such, adding ratings and reviews can have a great impact on the 
buying decisions of the shoppers. 

Ratings and reviews are commonly hosted by third-party providers. These 
providers can then offer dedicated review capabilities to filter out reviews with 
inappropriate content. The third-party provider chosen for the sample review 
feature in IBM WebSphere Commerce V7 is BazaarVoice, which you can find at: 
http : //www . bazaarvoi ce . com/ 


54 


Building Multichannel Applications with WebSphere Commerce 


Figure 2-14 shows an example excerpt from the reviews for the Red Leather Roll 
Arm Chaise product within Madisons Starter Store. 
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2.2.3 Product and category blogs 


Somewhat similar to reviews , product and category blogs also show regular 
shoppers’ opinions about products, but the format is more free-form. The blog 
functions allow other shoppers to comment on blog entries and, thereby, create 
more of a discussion forum. Product blogs are typically more centered around 
how individual shoppers use the products, as opposed to rating the product. 

Depending on the market segment, blogs can also be more than just entries 
about a specific product. For example, a home improvement site can have blogs 
where regular visitors blog about home improvement plans, project progress with 
links to specific products, or even wish lists. This sharing of information can be 
very powerful in the creation of a community. 

IBM WebSphere Commerce V7 ships with adapters that support blogs for the 
following products: 

► Pluck 

http://www.pl uck.com/ 

► IBM Lotus Connections V2.5 

http : //www. i bm. com/software/1 otus/products/connecti ons/ 

Figure 2-15 shows an example of a single blog entry for the Lounge Chairs 
category in Madisons Starter Store. 


Lounge Chair 

s Blog 

Refresh 

m 

Buying guide 
by: jd 

7/20/09 6:01 PM 

i) o Bo 

Lounge Chair 

5 Photo Gallery 

Refresh 

Be the first l 

iser to upload a photo, 



Figure 2-15 Blog and Photo Gallery entries for the Lounge Chairs category 


2.2.4 Photo and video galleries 

Although the reviews and blogs are primarily text-based, the photo and video 
gallery, allows customers to show action shots of the products. These 
photographs can be either humorous depictions of the products in special 
contexts, or more serious photos and videos showing how some shoppers have 
used the product in a special way. Merchants can also use the photo and video 
gallery to highlight special features or to show assembly instructions to shoppers. 
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IBM WebSphere Commerce V7 ships with adapters that support galleries for the 
following products: 

► Pluck 

http://www.pl uck.com/ 

► IBM Lotus Connections V2.5 
http://www.ibm.com/software/lotus/products/connections/ 

Figure 2-15 on page 56 shows the placement of the photo gallery for a category 
in Madisons Starter Store, although shoppers have not yet uploaded photos to 
that category. 


2.2.5 Social profile 

To support the more discussion-oriented components of Social Commerce (for 
example, blogs and galleries), customers need to create a public, or social, 
profile. While the profile that is set up as part of the standard IBM WebSphere 
Commerce registration flow is very personal and is expected to contain precise 
personal information about the shopper, the social profile typically contains only 
information that the shopper wants to share. The user name is often without 
resemblance to the shopper’s real name, and the standard fields exposed in IBM 
WebSphere Commerce V7 for a social profile are limited to the following fields: 

► Screen Name 

► E-mail Address 

► Hometown 

► Birthday 

► Gender 

► Interests 

All of these fields, apart from the screen name, are optional, allowing shoppers to 
share only as much information as they are comfortable. Figure 2-16 shows the 
registration form for creating a social profile. 
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Email Address: 

1 1 


Birthday; 


yyyy/mm/dd 

Gender; 

I ■ 




Figure 2-16 Creating a social profile 


2.2.6 Social Commerce integration 

As mentioned in the previous sections, Social Commerce features in IBM 
WebSphere Commerce V7 require integration with either third-party service 
providers or applications. In this section, we describe the integration method for 
adding Social Commerce features to IBM WebSphere Commerce V7. 

The chosen integration method is using a REST-based API integrated using 
WebSphere sMash VI .1 from Project Zero: 
http://www.projectzero.com/ 

The WebSphere sMash server acts as a mediator between the client and the 
service provider, providing a generic Representational State Transfer (REST) 
API. IBM WebSphere Commerce V7 ships with sMash adapters for BazaarVoice, 
Pluck and IBM Lotus Connections V2.5 that then transform the generic REST 
requests to the specific API for each of the supported service providers. 
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Figure 2-17 illustrates the integration architecture for the Social Commerce 
implementation in IBM WebSphere Commerce V7. 



Figure 2-17 The Social Commerce integration architecture through WebSphere sMash 


For more information about building WebSphere sMash applications, refer to 
Building Dynamic Ajax Applications Using WebSphere Feature Pack for Web 
2.0, SG24-7635. 


2.3 Marketing improvements 

IBM WebSphere Commerce V7 introduces many new marketing features. You 
now get more control on how you identify the customer throughout multiple 
channels, create customer segments based on demographics, and target 
appropriate promotions based on customer browsing behavior. These controls 
greatly enhance conversion rates because shoppers see only highly 
personalized and relevant marketing content based on their current and past 
actions. 
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2.3.1 New promotion types 

Promotions enable you to offer customers incentives to purchase. WebSphere 
Commerce supports numerous types of promotions, such as price promotions 
including simple discounts, merchandise specials such as gifts with purchase 
and buy-one-get-one, and service promotions including reduced shipping costs. 

Business users create and manage promotions using the Promotions tool in the 
Management Center. 

IBM WebSphere Commerce V7 offers the following new promotion types: 

► Order level: Amount off shipping 

This promotion type offers an amount off the shipping charges when the total 
value of the order meets or exceeds a specified amount (for example, the 
customer receives $10 off shipping on orders over $100). 

► Product level: Fixed shipping discount 

This promotion type offers an amount off the shipping charges when the order 
contains a specified number of catalog entries or a specified amount is spent 
on the catalog entries (for example, buy two or more “Villagois” Table Glasses 
and get free shipping). 

► Category level: Fixed shipping discount 

This promotion type offers shipping at a fixed price when the customer 
purchases a specified number of items or spends a specified amount on 
catalog entries from category X in one order (for example, buy two or more 
items from the Table Glasses category and get free shipping). 

► Multiple items percent discount 

This promotion type offers a percentage off a specific combination of items 
when the order contains all the items (for example, buy four “Villagois” Table 
Glasses and four “Villagois” Wine Glasses and get 10% off all these items). 


Important: To avoid unexpected results at the storefront, item A and item B 
must be mutually exclusive. In other words, item A cannot include item B, and 
item B cannot include item A. For example, if item A is any item from the Hat 
category and item B is a fishing hat (a SKU within the Hat category), then this 
promotion is not valid because item A includes item B. This rule also applies if 
you have additional items in the purchase condition (items A, B, C, and D). 
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2.3.2 Deprecated promotion adjustments 


The following promotion types are deprecated in IBM WebSphere Commerce V 7 
and are not available in promotion tool: 

► Percent off volume discount 

► Amount off volume discount 


2.3.3 New promotion features 

The IBM WebSphere Commerce promotion engine is enhanced and now 
supports the features that we describe in this section. 

Maximum amount for discounts 

If the selling price is high, the discount amount after calculation can be large. IBM 
WebSphere Commerce V7 allows you to fix a cap on the discount amount (for 
example, 20% off greeting cards but only up to $2). You can place the cap for 
both order-level promotion (as shown in Figure 2-18) and product-level promotion 
(as shown in Figure 2-19). 


* Minimum Order Purchase (USD) 

* Percentage Discount on Order (%) 

Maximum Discount Amount (USD) 


100.00 [5 

[30.00 


1,000.00 

10 

[300.00 


5,000.00 

15 

[l,500.00 ~ 




1 to 3 of 3 


Figure 2-18 Maximum discount amount on order-level promotion 


"Quantity of “X” needed to 1 10 
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*Quantity of additional 
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*Percentage discount off js 
additional catalog entries “X" 


Maximum discount amount © 15.00 
on additional catalog 
entries "X” (USD) 
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Figure 2-19 Maximum discount amount on product-level promotion 
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Payment type based 

IBM WebSphere Commerce V7 allows you to reward a customer for using a 
particular payment type (for example, 1 0% off an order when paid with a store 
credit card). This feature requires a single payment type per order, as shown in 
Figure 2-20. Orders paid using multiple payment types do not qualify for the 
promotion. 


v Purchase Condition and Reward 


<Q m If] 

"Minimum purchase condition * Minimum Order Purchase (USD) | * Amount Off (USD) 
100.00 | [ 10.00 

| *Target payment type [ VISA Credit Card ~R]j 


Figure 2-20 Full order must be paid for with the required payment type 


Choice of free gift 

IBM WebSphere Commerce V7 allows you to offer free gifts to customers from a 
list of options, providing you the opportunity to offer multiple free gifts. 

Figure 2-21 shows how marketing managers can create a list of products in the 
Management Center that can be offered as free gifts to the shoppers. 



Figure 2-21 Choosing a free gift option 
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When shopping on the Web site, the user is presented with a list of promotional 
products (Figure 2-22) that are configured by the marketing manager using the 
promotion tool. The customer can choose a product from this list. 


dose E3 


Select your free gifts 

(• I would like the following free gifts (choose up to 2 gifts) 
C I do not want any free gifts 


; 1 

5 -Piece Kitchen Utensil Set 

fw Everyday kitchen utensils in a container. 

$&^5 

$8.99 

: i! 

a Spoons and Spatulas 

[II = 

$4.99 

r IS 

Measuring Spoons 

»*> — — 

$0.05 

$7.99 

d 


| Cancel \ 

Figure 2-22 List of promotional products 


Attribute filtering 

While creating promotions, you can use product attributes to filter catalog entries 
to which the promotion applies (for example, 10% off red shirts as shown in 
Figure 2-23). 


t) a ill 

Attributes for catalog © 

* Attribute Name * Data Type * Matching Rule * Value 

Trim Color Text Attribute value car ... ■» Black-and-white che' 




Figure 2-23 Filter catalog entries based on attribute 
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Best deal calculation 

The promotion engine supports an optional best deal feature that compares 
promotions that have the same priority automatically and applies them in the 
sequence that offers the lowest overall purchase price. The best deal feature 
runs only when: 

► A customer’s order qualifies for multiple promotions in the same promotion 
group 

► Multiple promotions have the same priority 


Important: Because of performance reasons, even after you enable the best 
deal feature, aim to control which promotions are applied first to a customer’s 
order by assigning those promotions a higher priority. When you cannot 
predict the best deal in advance, assign the conflicting promotions the same 
priority, and let the best deal feature do the math. 



Figure 2-24 Traditional promotion evaluation 


In previous versions of IBM WebSphere Commerce, when multiple promotions 
have the same priority, the promotion engine builds up a default sequence of 
promotions and applies them, which might or might not offer the best discounts 
for the customer. However, in IBM WebSphere Commerce V7, when you enable 
the best deal feature, the promotion engine builds all sequence combinations 
(subject to a defined threshold) for promotions that have same priority. These 
sequences are then evaluated, and the best result is selected, as shown in 
Figure 2-25. 
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Figure 2-25 Best-deal support based on threshold 


2.3.4 Precision marketing 

Precision marketing refers to targeting content towards user based on current 
and past actions. Marketing content can be targeted towards both registered and 
guest users. The Management Center provides a rich Ul that you can use to 
enable precision marketing. 


Note: Precision marketing works using the personalization ID, which uniquely 
identifies a user and allows WebSphere Commerce to present the user with 
personalized content when the user interacts with the business, throughout 
the business life cycle. By default, the persistent session and personalization 
ID features are disabled. If not enabled, the customer segment and order 
purchase history targets can only target a customer based on the current 
member ID of that customer. 
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Figure 2-26 shows an Web activity diagram from the Management Center that 
displays the commonly used terms in precision marketing. 



New targets 

A target defines which customers experience marketing activities. When a 
customer reaches a target in the activity flow, the customer is evaluated against 
the target criteria. For example, the criteria for a Purchase History target might be 
that the customer has placed exactly five orders. Targets are typically based on a 
customer’s behavior and segmentation. If you do not include targets in an activity, 
then the activity applies to all customers. 

IBM WebSphere Commerce V7 introduces the following targets: 

► Catalog Browsing Behavior 

You can use Catalog Browsing Behavior to target customers who have 
browsed specific parts of the store catalog while shopping on the Web site 
over time. For example, if a customer has repeatedly browsed certain 
categories, then that customer is a prime target for advertisements or 
promotions that are related to those categories. 

► External Site Referral (not for Dialog activities) 

You can use External Site Referral to target customers who entered the Web 
site from a link on a specific external site. 
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► Social Commerce Participation 

You can use Social Commerce Participation to target customers who have 
participated in social commerce on the Web site a specified number of times. 
Customers participate in Social Commerce when they do any of the following 
activities on your site: 

- Post a product review or comment, or rate a product 

- Post a blog entry or comment, or rate a blog entry 

- Upload a photo or video 

► Current Page (not for Dialog activities) 

You can use the Current Page to target customers who are currently viewing a 
specific page of the store. For example, this target might be a display page for 
a specific part of the catalog or a search results page following a specific 
keyword search. 

► Online Behavior 

You can use Online Behavior to target customers whose recorded behavior 
while shopping on your site over time meets certain criteria. The recorded 
behavior of customers can provide important clues about their interests. You 
can use these clues to personalize marketing messages. For example: 

- Customers who have searched the site using the keyword “television” 
within the last week. 

- Customers who have visited store pages with page URLs that contain 
certain data. 

► Cookie Contents (not for Dialog activities) 

You can use Cookie Contents to target customers whose computers have a 
cookie from your site that contains certain data (for example, a zip code that 
indicates that the customer lives in a certain geographical area). This target is 
useful for targeting guest users who have not logged in but who have 
sufficiently browsed the site providing useful bits of information. 

► Day and Time 

You can use the Day and Time to specify the days of the week and times of 
day that an activity is active. If an activity uses the Branch element and has 
more than one path, use this target to set a different schedule for each path. 

New actions 

An action defines what to do based on the previous sequence of triggers and 
(optionally) targets in the activity flow. An action is a step to perform as part of the 
activity flow. In a Web activity, an action typically displays something in an 
e-Marketing Spot. In a Dialog activity, an action can send the customer an e-mail 
or text message or can add the customer to a customer segment. 
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IBM WebSphere Commerce V7 introduces the following new actions: 

► Recommend Promotion 

► Add to or Remove from Customer Segment 

► Display Recently Viewed 

New branch type 

A branch allows you to define an alternate action or more than one course of 
action in an activity flow. IBM WebSphere Commerce V7 introduces the following 
new branch type: 

► All paths for which the customer qualifies 

New Dialog activity 

IBM WebSphere Commerce V7 introduces Dialog activity. It is similar to a Web 
activity, but it allows multi-step interaction that is initiated by specific customer 
action. Dialog activity extends beyond e-Marketing Spots, because it allows you 
to track customer behavior over a period of time and to take actions accordingly. 
Figure 2-27 shows a sample Dialog activity. 


Note: If Dialog activity is waiting (for example on a wait trigger), the activity 
does not continue until that path is complete. 
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Customer Abandons Shopping Cart 
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Customer Places Order 

Issue Coupon 
15% off your 


Figure 2-27 Sample Dialog activity 
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Note: A Trigger defines the event that causes an activity to start or to 
continue. Web activities have the following characteristics: 

► Web activities always start with the e-Marketing Spot trigger. 

By default, the e-Marketing Spot trigger is included as the first element in 
all standard Web activity templates. The Web activity is triggered when a 
customer views the page containing the e-Marketing Spot. 

► A Web activity cannot have more than one trigger. 

Dialog activities have the following characteristics: 

► Dialog activities can start with any trigger that is available in the palette. 
In most cases, triggers are customer events (for example, a customer 
registers or places an order). Additionally, a trigger can be an elapsed 
period of time (for example, a week). When the trigger that you specify 
occurs, the Dialog activity proceeds. 

► A Dialog activity can have multiple triggers. 


A Dialog activity supports the following specific triggers: 

► Wait 

► Customer Places Order 

► Customer Abandons Shopping Cart 

► Customer Registers 

► Customer Participates in Social Commerce 

► Customer is in Segment 

A Dialog activity supports the following specific actions: 

► Send Message 

► Issue Coupon 


2.4 Management Center enhancements 

Management Center is the preferred tool for creating and managing promotions 
and marketing activities. In this section, we discuss the new features in 
Management Center with IBM WebSphere Commerce V7. 
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2.4.1 Activity templates 


Activity templates provide a starting point to create a new marketing activity, 
avoiding any repetitive work. You can choose from the default templates provided 
by IBM WebSphere Commerce, or you can create new templates that suit your 
requirements. Activity templates and marketing activities share the same 
namespace. So, you must ensure that the name for an activity template is unique 
among all activity templates and marketing activities. 

Figure 2-28 shows the standard templates that are available in Management 
Center. 


iw Activity From Template 


! ^ 1 

Type Name i 

H Search Results 

ifljj Blank Web Activity 

1 Standard Templates 
L^i Custom Templates 

ifiS Category Recommendation 

1 i All Templates 

Content Recommendation 


fiS Merchandising Association 

Recommendation 


Catalog Entry Recommendation 


fiS Promotion Recommendation 


1 to 6 of 6 


Recommend any type of content to a customer that 
satisfies the chosen target conditions. 


OK I Cancel 


Figure 2-28 Activity template picker 
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2.4.2 Customer segments 


Management Center now supports the ability to create customer segments. The 
Ul is simple to use. A new option is added to allow marketing activities to add and 
remove customers automatically from a segment (Figure 2-29) so that you can 
support user segments implicitly through marketing activities without having to 
actively manage the same. 



2.4.3 Statistics 

Management Center can display the statistics that the IBM WebSphere 
Commerce marketing engine collects. These statistics provide a good idea of the 
effectiveness of various Web activities. You can check the statistics at any time 
while the activity is running or after it becomes inactive. 

Experiment statistics 

These results help determine whether the current marketing effort is effectively 
maximizing revenue by targeting the right audience with the most appropriate 
message. If not, incorporating the experiment path into the control path might 
improve the efficiency of the marketing message. Figure 2-30 shows the 
experiment statistics view in Management Center. 


Tip: Experiments in the Management Center support multiple experiment 
paths in any given experiment. The optional paths are called experiment 
paths, and the original path is called the control path. 
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Figure 2-30 Experiment statistics 

Customer counters in campaign activities 

The Activity Builder displays customer counters under each element in a 
campaign activity (Figure 2-31). The number indicates how many customers 
have reached a particular trigger, target, or action in the activity since it was 
activated. By default, the customer count numbers are updated every 15 
minutes. 




A 



1 e r 

— B — 

e-Marketing Spot 
StoreHomePage 
Customer Count: 4 

— X? — 

Branch 

top 

50% 

1=1 

Display Content 
Buy One, Get 

Customer Count: 1 

^ 




bottom 

50% 

m i 

Display Content 
Free Ground 
Shipping 

Customer Count: 3 


Figure 2-31 Activity element counters in the Web activity diagram 
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E-Marketing spot statistics 

The Marketing tool displays statistics for e-Marketing Spots used in Web 
activities. For a given activity, the statistics show the number of times the server 
has displayed content in the e-Marketing Spot, the number of times a customer 
has clicked the content, and the associated click-through rate (Figure 2-32). 
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Figure 2-32 E-Marketing spot statistics 


E-mail activity statistics 

The Marketing tool displays statistics for e-mail activities. For a given e-mail 
activity, you can review statistics that are related to both e-mail delivery and 
e-mail effectiveness as shown in Figure 2-33. This data can help you evaluate 
the effectiveness of e-mail activities while they are in progress and when they are 
complete. 
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2.5 Utilities 


IBM WebSphere Commerce V7 introduces a new data loading utility to allow you 
to upgrade from older editions and to use the latest features available in the new 
edition. 

Data load refers to loading data from external data sources to WebSphere 
Commerce database. Typically, data loading includes the following scenarios: 

► Initial data loading is the first time that you load the data into the database. 
Usually, a large amount of data is involved with the initial data loading. 

► Delta load is used for data insert, update, and delete. Delta load can happen 
daily or weekly. 

IBM WebSphere Commerce V 7 improves upon the massl oad tool for data loading 
in earlier versions. Now, loading data is a single step data load from a CSV file to 
an IBM WebSphere Commerce DB. There is no need to generate intermediate 
files. 

This new data load solution is based on the WebSphere Commerce business 
objects. To use this new data load tool, you need to understand the WebSphere 
Commerce business object schema instead of the physical database schema. 
You now need to have only CSV input files and to map the columns in the CSV 
file to the components of the logical business objects using XPath. 

In IBM WebSphere Commerce V7, data load supports catalog and catalog 
related components, such as catalog group, catalog entry, merchandise 
association; as well as price and inventory for the catalog entries. Other data 
such as orders, promotions, and contracts will be delivered in future releases. 

In IBM WebSphere Commerce V 7, you can still use the massl oad tool. If you want 
to load components other than catalog, price, and inventory, you can either 
customize the new data load or use the existing massload tool. 
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2.6 Stack update 


IBM WebSphere Commerce V7 builds upon the latest Java EE 5 technology and 
provides a state-of-the-art development tool using IBM Rational Application 
Developer V7.5. The following software is compatible for IBM WebSphere 
Commerce V7: 

► IBM WebSphere Application Server V7 

► IBM Rational Application Developer V7.5 

► IBM DB2 V9.5 

For a complete list of supported operating systems, databases, servers, and 
browsers, refer to the WebSphere Commerce Version 7 Information Center: 
http : //pub! ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp 
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Distributed order 
management integration 


This chapter provides an overview of WebSphere Commerce order and inventory 
management systems and distributed order management (referred to as DOM in 
this book). It also provides information about the DOM integration framework as 
well as a sample DOM integration scenario with detailed steps. 

This chapter includes the following topics: 

► Overview of WebSphere Commerce order management and inventory 
management 

► Integration of WebSphere Commerce with the DOM solution 

► Implementation of WebSphere Message Broker mediation module for DOM 
integration 

► Implementing WebSphere Enterprise Service Bus mediation module for DOM 
integration 

► Configuring the DOM integration feature 


© Copyright IBM Corp. 2010. All rights reserved. 
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3.1 Overview of WebSphere Commerce order 
management and inventory management 

The WebSphere Commerce order management and inventory management 
consists of the following steps: 

1 . Orders are captured online by the storefront or through other channels, such 
as call center, kiosks, and so on. 

2. The orders are sent to the WebSphere Commerce order management system 
for further processing. 

3. During the order capturing and processing, inventory services such as 
checking inventory availability, reserving inventory, and reversing inventory 
reservation are needed. WebSphere Commerce informs the inventory 
management systems about available to promise (ATP) and non-ATP. 

3.1 .1 WebSphere Commerce order management 

Order capture and processing are important components in an electronic 
commerce system. In WebSphere Commerce, there are different channels for 
order capture: 

► Online shoppers can submit orders from the storefront. 

► Shoppers can place a call to an IBM WebSphere Commerce call center to ask 
a customer service representative to place an order. 

► Using a mobile phone, a shopper can purchase items by using the mobile 
storefront. 

► A shopper can purchase items by using a kiosk. 

Detailed steps about placing an order in WebSphere Commerce Madisons 
Starter Store can be found in 4.2, “Buy online, pick up in store” on page 134. 

After the order is placed, an administrator can log on to WebSphere Commerce 
Accelerator to find the order and process it. 
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Figure 3-1 illustrates the user interface in WebSphere Commerce Accelerator 
that is used to find an order. 


Fnnlish 



Figure 3-1 Find orders in WebSphere Commerce Accelerator 


After orders are found, the administrator can do future processing on them. For 
the orders that have ATP inventory or non-ATP inventory through WebSphere 
Commerce, the order flow after capture is as follows: 

1 . Approve the order, if needed. 

2. Approve the payment of the order. 

3. Release the orders to the fulfillment centers. 

4. Create a pick batch. 

5. View and print pick tickets. 

6. View and print packaging slips. 

7. Pick and pack the products. 

8. Create a package. 

9. Ship the goods to customers. 

10. Confirm the shipment. 

1 1 .Close the order. 

For more information, refer to the Order flow process topic in the WebSphere 
Commerce Version 7 Information Center at: 

http : //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?topi c= 
/com. ibm. commerce. user. doc/concepts/coosorderfl owprocessgeneral .htm 


Chapter 3. Distributed order management integration 79 



For DOM inventory, after the orders have been captured, they are transferred to 
the DOM system. The orders’ status will be synchronized with DOM when 
needed. More operations to process the order are performed by the DOM 
system. 

To better support the order capture, order management, and order integration 
with external system, WebSphere Commerce supplies order services through 
the service-oriented architecture (SOA) approach, which include: 

► GetOrder service 

► ChangeOrder service 

► ProcessOrder service 

► SyncOrder service 

The GetOrder service is used to retrieve the order information for an order. It is 
usually used in a Web 2.0 starter store to display order information to online 
shoppers. For more information about the GetOrder service, refer to the Get 
Order topic in the WebSphere Commerce Version 7 Information Center at: 
http : //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?topic= 
/com. ibm. commerce. webservi ces . doc/ ref s/rwvgetorder.htm 

The ChangeOrder service can be used to create a new order, add an order item 
to an order, and update the order. When online shoppers add something to their 
shopping cart or modify their shopping cart, this service will be invoked. 

The ProcessOrder service is used to perform processes on the shoppers order. 
For example, when the online shoppers try to check out, the process service will 
be invoked to do some preparations for the order. 

The SyncOrder service is used to synchronize the order information with external 
order management systems. Usually when the order in an external order 
management system has been changed, the external order management system 
can invoke this order service to synchronize the order status in WebSphere 
Commerce. 

For more information about these order service, refer to the SOI and BOD 
service modules topic in the WebSphere Commerce Version 7 Information 
Center at: 

http: //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?topic= 
/com. ibm. commerce. devel oper.soa.doc/concepts/csdcompare.htm 

Note: The order system of WebSphere Commerce can be integrated 
seamlessly into an SOA system. 
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3.1.2 WebSphere Commerce inventory management 


WebSphere Commerce supplies two types of inventory management systems, 
which satisfy different customer requirements: 

► ATP inventory management system 

► Non-ATP inventory management system 

ATP inventory 

In an ATP system, the inventory that is available in stock (on hand) plus the 
inventory that is on order, not including inventory that is currently being 
processed, reserved, or allocated to back orders, can be processed when 
processing orders. 

With ATP inventory, if there is a sufficient inventory on hand, the order can be 
fulfilled with a fulfillment status of allocated. Otherwise, if there is no sufficient 
inventory on hand, but there is sufficient inventory expected in the future, the 
order can be fulfilled with a fulfillment status of back ordered. Thus, both orders 
can be successfully placed. 

Non-ATP inventory system 

The non-ATP inventory is a simpler model than ATP inventory. It can only handle 
the inventory on hand. If there is no inventory on hand, the order cannot be 
placed successfully, and there are no sufficient inventory warning messages. 

For more information about non-ATP inventory, refer to the Non-ATP inventory 
information model topic in the WebSphere Commerce Version 7 Information 
Center at: 

http : //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?topic= 
/com. i bm. commerce. data. doc/concepts/ci n_iminventoryasset3.htm 
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WebSphere Commerce Accelerator supplies friendly user interfaces for the 
administrators to manage the ATP inventory and non-ATP inventory, for example, 
on hand quantity adjustment, expected inventory adjustment of ATP, and so on. 
Figure 3-2 shows how to adjust the available quantity of a product. 



Figure 3-2 Adjust available quantity of a product 
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Note: Many of management tasks can be completed in IBM Management 
Center for WebSphere Commerce. The Management Center for IBM 
WebSphere Commerce is the next generation business user tool for managing 
online business tasks, for example, catalog, marketing, and promotional tasks. 
It was introduced in IBM WebSphere Commerce V6 Feature Pack 3. Some of 
the management tasks are only available in WebSphere Commerce 
Accelerator. 

For more information about the IBM Management Center of WebSphere 
Commerce, refer to the following resources: 

► The WebSphere Commerce Version 7 Information Center at: 

http : //publ ib. boulder. ibm.com/infocenter/wchel p/v7r0m0/index.jsp? 
topi c=/com.ibm. commerce. management- center. doc/tasks/ttf general .htm 

► WebSphere Commerce Line-Of-Business Tooling Customization, 
SG24-7619, located at: 

http://www.redbooks.ibm.com/redbooks/pdfs/sg247619.pdf 


Enhancement of ATP inventory and non-ATP inventory in IBM 
WebSphere Commerce V7 

In IBM WebSphere Commerce V7, ATP inventory and non-ATP inventory have 
been enhanced to support the buy online and pickup in store scenarios (referred 
to as BOPIS in this book). For more detailed information about BOPIS, refer to 
4.2, “Buy online, pick up in store” on page 134. 

After the enhancement, the GetlnventoryAvailability services can be used to 
retrieve the inventory availability of catalog entries in online stores or stores. This 
service is used by the product detail display page of the Madisons Starter Store 
to display the inventory availability to the online shoppers. 

The online shoppers can complete an end-to-end BOPIS scenario with ATP and 
non-ATP inventory systems, just as they can do with the DOM integration 
solutions. (For more information about DOM, refer to 3.2, “Integration of 
WebSphere Commerce with the DOM solution” on page 84.) Shoppers can log 
on to an online store, select their favorite store from the Store Locator, add a 
product into the shopping cart, and pick it up at their favorite store. 

For step-by-step guides of BOPIS scenarios, refer to 4.2.2, “BOPIS in Madisons 
Starter Store” on page 1 35. 
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3.2 Integration of WebSphere Commerce with the DOM 
solution 


In this section, we discuss the WebSphere Commerce DOM solution, including 
an overview of the DOM solution, the integration structure of DOM, and the 
general steps to develop a mediation module of DOM. 


3.2.1 WebSphere Commerce DOM solution overview 

DOM is an external order management system or application responsible for 
processing the order, editing the order, and releasing the order to the appropriate 
fulfillment system. In most cases, inventory will be also be managed by this 
external system. 

For an example scenario, a customer already has an existing order management 
system or wants to use a third-party order management system to process their 
online orders captured from WebSphere Commerce. The external order 
management system will be responsible for processing the order, editing the 
order, and releasing the order to the appropriate fulfillment system, as well as the 
orders returned. 

WebSphere Commerce supplies new features to support this DOM system. As of 
Version 6 Feature Pack 5, DOM integration is part of the cross channel 
integration solutions in WebSphere Commerce. It is a back-end system 
integration that enables integration with DOM systems to provide a 
comprehensive coverage of the order life cycle, from capture to fulfillment across 
channels. 

With DOM, the orders are captured from the WebSphere online storefront. These 
orders are transferred to external order management systems by WebSphere 
Commerce order Web services. The orders status are changed in external order 
management systems and synchronized with WebSphere Commerce for 
management purposes. 

DOM integration supplies the following new features: 

► A new inventory component with SOA services to check inventory availability 
and process inventory requirements, including caching and DOM integration 
capabilities 

There is great flexibility in the inventory cache, which can use a distributed 
object cache mechanism in WebSphere Application Server or WebSphere 
Commerce databases through different configurations. 
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In the WebSphere Application Server distributed object cache mechanism, 
the DOM inventories are cached in the memory. The memory cache can 
serve the inventory request with a quicker response. In a cluster environment, 
the inventory caches are synchronized between different cluster members. 
For more information about IBM WebSphere Application Server distributed 
object caches, refer to the following topics in the WebSphere Commerce 
Version 7 Information Center: 

- Using the DistributedMap and DistributedObjectCache interfaces for the 
dynamic cache 

http : //publ ib. boulder. ibm. com/i nfocenter/was inf o/v7r0/i ndex. jsp?t 
opic=/com.ibm. websphere. nd.doc/info/ae/ae/tdyn_di stmap.html 

- Object cache instance settings 

http://publib.boulder.ibm.eom/infocenter/wasinfo/v7r0/topic/com.i 
bm. websphere . nd . doc/i nfo/ae/ae/udyn_cachei nstancescol 1 ecti on . html 

- Java document for class DistributedObjectCache 
http://publib.boulder.ibm.eom/infocenter/wasinfo/v7r0/topic/com.i 
bm. websphere. javadoc.doc/publ ic_html /api /com/i bm/websphere/cache/ 
Di stri butedObjectCache. html 

There is an extended version of the dynamic cache monitor, which can help 
monitor the distributed object caches. For more information about how to 
configure and use this extended dynamic cache monitor, refer to the following 
address: 

http : //www. i bm.com/devel operworks/websphere/downl oads/cache_moni tor . 
html 

With the WebSphere Commerce database cache, the DOM inventory records 
are resident in DB2 databases or Oracle databases. WebSphere Commerce 
has supplied an efficient approach to access these databases by way of a 
data service layer (DSL). 

For more information about WebSphere Commerce DSL, refer to the Data 
service layer topic in the WebSphere Commerce Version 7 Information Center 
at: 

http : //publ i b . boul der . i bm. com/i nfocenter/wchel p/v7r0m0/topi c/com. i bm 
. commerce. developer. soa.doc/concepts/csddsl .htm?resul tof=%22%44%73%6 
c%22%20%22%64%73%6c%22%20 

Whether the local DOM inventory cache is in memory or in database, it is 
configured in the WebSphere Commerce database. Store administrators can 
change these configurations to change the cache locations. 
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► A new store component with services for store location 

This new component gives WebSphere Commerce online shoppers the 
capability to find nearby stores based on entered locations. The shoppers can 
then pick up merchandise after they shop online or can go to the stores 
directly for shopping. 

► Enhancement of catalog browsing 

The enhancement of catalog browsing flow enables the shoppers to view 
product availability for certain stores. Before a shopper can see the 
availability, shoppers need to use Store location feature to select their favorite 
stores. They can also select the their favorite stores in the product detailed 
information display page. 

► Buy online, pick up in store support (referred to as BOPIS in this book) 

The online shoppers can buy online and pick up the merchandise in their 
favorite store. 

As of WebSphere Commerce V7, the BOPIS scenarios are supported with 
the ATP and non-ATP inventory systems. 

For more information about BOPIS, refer to 4.2, “Buy online, pick up in store” 
on page 134. 
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3.2.2 Shopping flow with DOM 


Integrated with DOM system, the shopping flow (which exploits the benefits of 
DOM system) of the WebSphere Commerce Madisons Starter Store is 
composed of several steps, as shown in Figure 3-3. 



Figure 3-3 Shopping flow in DOM integration solution 

The shopping flow uses the following steps: 

1 . The online shopper finds a product. 

2. The online shopper selects their favorite store to check out. 

3. WebSphere Commerce interacts with the DOM system to obtain the inventory 
availability of the product in the shopper’s favorite store. 

4. The shopper adds the product to the shopping cart. 

5. WebSphere Commerce interacts with DOM to check whether there is 
sufficient inventory. 
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6. The shopper checks out. 

7. WebSphere Commerce interacts with DOM to reserve inventory for this order. 

8. The online shopper submits the order. 

9. WebSphere Commerce transfers the order to DOM. 

10. The online shopper goes to the store and picks up the product. 

1 1 .The order status is updated. 

3.2.3 DOM integration structure 

The WebSphere Commerce runtime component supplies a flexible framework to 
integrate back-end systems. The DOM integration solutions works elegantly 
within this integration framework. 

Figure 3-4 shows the overall structure of the DOM integration solution. 
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The order capture component is supplied by WebSphere Commerce, which is 
invoked by the online storefront to capture the orders. WebSphere Commerce 
supplies different order services to order processing, including the GetOrder 
service, the ProcessOrder service, the ChangeOrder service, and the SyncOrder 
service. These services enable the storefront to access the order in a flexible and 
loosely coupled approach. 

The WebSphere Commerce SOA service client is the asset that is supplied by 
WebSphere Commerce. It can be used to invoke the SOA services through 
different bindings. On the WebSphere Commerce side, the service client can be 
used to invoke the external services or invoke services from different 
components inside of WebSphere Commerce. 
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The service client supplies utilities to compose the service message and to 
invoke the service, which can be used in the DOM side to gain quick access to 
WebSphere Commerce service. 

The outgoing service messages from the client APIs are taken as WebSphere 
Commerce outbound service messages. 

The message transformation module works to transform the WebSphere 
Commerce service messages to DOM messages and vice versa. For example, 
the request to the GetlnventoryAvailability service will be transferred to format 
that can be recognized by the DOM inventory system. When the response from 
DOM inventory comes, the message transformation module transfers the 
response message to a format that can be understood by WebSphere 
Commerce. This transformation module can be developed and deployed in IBM 
WebSphere Message Broker or IBM WebSphere Enterprise Service Bus. 


Note: For more information about how to development and deploy mediation 
modules, refer to 3.3, “Implementation of WebSphere Message Broker 
mediation module for DOM integration” on page 98, and 3.4, “Implementing 
WebSphere Enterprise Service Bus mediation module for DOM integration” on 
page 126. 


The DOM inventory management module is the system in which inventory is 
managed and is the back-end system to WebSphere Commerce. DOM inventory 
can expose inventory services such as inventory query, inventory reservation, 
and inventory cancellation with its owner message format. It can only 
communicate with WebSphere Commerce with the help of a message 
transformation module. 


Note: When WebSphere Commerce acts as a service consumer, a 
component client API is called from the WebSphere Commerce task 
command. The client API uses the invocation service, and the invocation 
service requires a deployed configuration file to determine how to 
communicate with the remote component. Each component has a separate 
configuration file to configure the client API. Each store can also have a 
version of the configuration file that takes precedence over the default 
configuration, which allows the store to override some of or the entire 
configuration without changing the default configuration. 
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3.2.4 DOM integration outbound messages 


A business object document (BOD) is a representation of a standard business 
process that flows within an organization or between organizations. BODs are 
defined by the Open Applications Group (OAG) using XML. 

The WebSphere Commerce SOA service messages comply with this BOD 
standard. There is an application area and a data area in WebSphere Commerce 
service message. There is a noun part and a verb part in the data area, which 
indicates that a verb takes action on the noun. For more information about 
WebSphere Commerce SOA and BOD, refer to the following topics in the 
WebSphere Commerce Version 7 Information Center: 

► SOI and BOD service modules 

http : //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?top 
ic=/com.ibm. commerce. developer. soa.doc/concepts/csdcompare.htm 

► Business Object Document (BOD) 

http: //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?top 
ic=/com.ibm. commerce. base. doc/mi sc/Bus iness_0bject_Document_%28B0D%2 
9.htm 

The DOM integration feature includes the following WebSphere Commerce 
outbound messages: 

► GetlnventoryAvailability/ShowInventoryAvailability 

► ProcessInventoryRequirement/AcknowledgelnventoryRequirement with 
action code Reservelnventory 

► ProcessInventoryRequirement/AcknowledgelnventoryRequirement with 
action code CancellnventoryReservation 

► ProcessOrder/AcknowledgeOrder with action code TransferOrder 

These outbound messages are transformed by the message transform module 
so that DOM can recognize that these messages can communicate with 
WebSphere Commerce. 

The Getlnventory Availability message is used to retrieve the inventory availability 
of catalog entries in online stores or in physical stores. The response to the 
request is in the ShowinventoryAvailability message. 
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The ProcessInventoryRequirement message processes the orders. Different 
action codes can be used in the request message for different purposes: 

► Checklnventory 

The action code Checklnventory checks the inventory availability for the order 
items in an order. 

► Reservelnventory 

The action code Reservelnventory reserves inventory from the DOM 
inventory system. 

► DecrementCache 

The action code DecrementCache decrements the local DOM inventory 
cache when inventories are reserved successfully from the DOM inventory. 

► Cancel Inventory Reservation 

The action code CancellnventoryReservation cancels an inventory 
reservation from the DOM inventory. 

Among these action codes, Reservelnventory and CancellnventoryReservation 
are used as the outbound service messages, which are transformed before going 
to DOM. Other action codes are used internally by WebSphere Commerce in the 
DOM solution. 

The ProcessOrder message with action code TransferOrder is used to transfer 
the orders captured by the WebSphere Commerce Madisons Starter Store to 
DOM. After a successful transfer, the orders have life cycles in DOM. 

The sample message in Example 3-1 retrieves the inventory availability of 
catalog entry ID 10002 in online stores 10001, 10037, and 10026. 

Example 3- 1 GetlnventoryAvailability request sample message 

<_inv:GetInventoryAvailabi 1 ity releaseID="9.0" vers i on I D=" 7. 0.0.0" 
xml ns :_i nv="http://www. i bm. com/xml ns/prod/commerce/9/i nventory" 
xml ns :_wcf=" http://www.ibm.eom/xmlns/prod/commerce/9/foundat ion" 
xml ns :oa=" http: //www. openappl icati ons.org/oagi s/9 "> 

<oa:Appl icationArea xsi :type="_wcf : Appl icati onAreaType"> 
<oa:CreationDateTime>2009-08-10T18:23:32.796Z</oa:CreationDateTime> 
<oa:B0DID>e8ec0441-85da-llde-aea5-84214a8064d5</oa:B0DID> 

<_wcf :BusinessContext/> 

</oa: Appl i cat ionArea> 

<_inv:DataArea> 

<oa:Get> 

<oa:Expression 

expressionLanguage="_wcf :XPath">{_wcf .ap=IBM_Store_Detail s}/InventoryAv 
ai labi 1 ity [InventoryAvai labil ity Identifier/ External Identifier[CatalogEn 
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tryIdentifier[(UniqueID=' 10002')] and 
(Onl ineStoreldentif ier[ (Uni quel D=' 10001' )] or 
PhysicalStoreIdentifier[(UniqueID=' 10037' or 
Uni quel D= ' 10026 ')])]] </oa : Expressi on> 
</oa:Get> 

</_inv:DataArea> 

</_i nv : Get InventoryAvai 1 abi 1 i ty> 


Note: There is one verb get for the data area of the GetlnventoryAvailability 
BOD. There is no noun for this message, because all the necessary 
information to retrieve inventory availability is contained in the expression. 

In WebSphere Commerce, each expression has several parameters. In this 
sample: 

► The expression expressi onLanguage=”_wcf:XPath” specifies that the 
expression should be parsed by XPath. 

► The expression _wcf .ap=IBM_Store_Detai 1 s specifies that this request 
uses an access profile of IBM_Store_Details. 

The remaining part of the expression is the XPath to retrieve inventory 
availability, which is used by DSL to retrieve the data from databases. 

You can find more information in the Get Request and the Show Response 
topic in the WebSphere Commerce Version 7 Information Center: 
http ://publ i b . boul der . i bm. com/i nfocenter/wchel p/v7r0m0/i ndex. j sp?topi c 
=/com.ibm. commerce. webservices.doc/concepts/cwvget.htm 


The sample response in Example 3-2 gives a confirmation to the request that 
there is sufficient inventories with 555 available for online store 10001 , 200 
available for store 10037, and 959 available for store 10026. 

Example 3-2 ShowInventoryAvailability response sample 

<_i nv:ShowInventoryAvai 1 abi 1 i ty rel easel D= "9 .0" 
xml ns :_i nv="http://www. i bm. com/xml ns/prod/commerce/9/i nventory" 
xml ns :_wcf=" http://www.ibm.eom/xmlns/prod/commerce/9/foundat ion" 
xml ns :oa=" http: //www. openappl icati ons.org/oagi s/9 "> 

<oa:Appl icationArea xsi :type="_wcf : Appl icati onAreaType"> 
<oa:CreationDateTime>2009-08-10T18:23:34.921Z</oa:CreationDateTime> 
<oa:B0DID>ea304410-85da-llde-aea5-84214a8064d5</oa:B0DID> 

</oa: Appl i cat ionArea> 

<_inv:DataArea> 

<oa:Show recordSetCompl etelndi cator="true" recordSetCount="3" 
recordSetStartNumber="0" recordSetTotal ="3"> 
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<oa :Ori gi nal Appl i cati onArea> 
<oa:CreationDateTime>2009-08-10Z</oa:CreationDateTime> 
<oa:B0DID>e8ec0441-85da-llde-aea5-84214a8064d5</oa:B0DID> 
</oa:OriginalAppl icationArea> 

</oa:Show> 

<_i nv : InventoryAvai 1 abi 1 i ty> 

<_i nv : InventoryAvai 1 abi 1 i tyldenti f i er> 

<_wcf: External Identifier 
<_wcf: Catalog Entry Identifier 
<_wcf : Uni quel D>10002</_wcf : Uni quel D> 

<_wcf : External Identi f i er 
<_wcf : PartNumber>FUL0-0101</_wcf : PartNumber 
</_wcf: External Identifier 
</_wcf :CatalogEntryIdentifier> 

<_wcf :0nl ineStoreldentifier 
<_wcf : Uni quel D>10001</_wcf : Uni quel D> 

<_wcf : External Identi f i er 

<_wcf: Name Identi f i erMadi sons</_wcf: Name Identi f i er 
</_wcf: External Identifier 
</_wcf :0nl ineStoreldentifier 
</_wcf: External Identifier 
</_i nv : InventoryAvai 1 abi 1 i tyldenti f i er 
<_inv: InventoryStatus>Avai lable</_inv: InventoryStatus> 

<_i nv : Avai 1 abi eQuanti ty uom="C62">555 . 0</_i nv : Avai 1 abi eQuanti ty> 
</_i nv : InventoryAvai 1 abi 1 i ty> 

<_i nv : InventoryAvai 1 abi 1 i ty> 

<_i nv : InventoryAvai 1 abi 1 i tyldenti fi er 
<_wcf: External Identifier 
<_wcf: Catalog Entry Identifier 
<_wcf : Uni quel D>10002</_wcf: Uni quel D> 

<_wcf : External Identi f i er 
<_wcf : PartNumber>FUL0-0101</_wcf : PartNumber 
</_wcf: External Identifier 
</_wcf :CatalogEntryIdentifier> 

<_wcf : Physi cal Storeldenti f i er 
<_wcf : Uni quel D>10037</_wcf : Uni quel D> 

<_wcf : External Identi f i erCal gary Ci rcl e 
Mai l</_wcf: External Identifier 

</_wcf: Physi cal Storeldenti f i er 
</_wcf: External Identifier 
</_i nv : InventoryAvai 1 abi 1 i tyldenti f i er 
<_inv: InventoryStatus>Avai lable</_inv: InventoryStatus> 

<_i nv : Avai 1 abi eQuanti ty uom="C62">200 . 0</_i nv : Avai 1 abi eQuanti ty> 
</_i nv : InventoryAvai 1 abi 1 i ty> 

<_i nv : InventoryAvai 1 abi 1 i ty> 
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<_i nv : InventoryAvai 1 abi 1 i tyldenti f i er> 

<_wcf: External Identifier 
<_wcf: Catalog Entry Identifier 
<_wcf : Uni quel D>10002</_wcf : Uni quel D> 

<_wcf : External Identi f i er 
<_wcf : PartNumber>FUL0-0101</_wcf : PartNumber 
</_wcf: External Identifier 
</_wcf :CatalogEntryIdentifier> 

<_wcf : Physi cal Storeldenti f i er 
<_wcf : Uni quel D>10026</_wcf : Uni quel D> 

<_wcf : External Identi f i erCal gary 
Mai l</_wcf: External Identifier 

</_wcf: Physi cal Storeldenti f i er 
</_wcf: External Identifier 
</_i nv : InventoryAvai 1 abi 1 i tyldenti f i er 
<_inv: InventoryStatus>Avai lable</_inv: InventoryStatus> 

<_i nv : Avai 1 abi eQuanti ty uom="C62">959 . 0</_i nv : Avai 1 abi eQuanti ty> 
</_i nv : InventoryAvai 1 abi 1 i ty> 

</_inv:DataArea> 

</_inv:ShowInventoryAvai 1 abi 1 i ty> 


Note: The data area of ShowInventoryAvailability BOD is composed of one 
verb show and three InventoryAvailability nouns. Each noun is for a 
combination of a catalog entry and a store. 


3.2.5 DOM integration inbound message 

A list of inbound messages is used for the DOM integration solution: 

► SyncInventoryAvailability/ConfirmBOD 

► SyncOrder/ConfirmBOD 

SyncInventoryAvailability/ConfirmBOD is used by the SyncInventoryAvaiability 
service to synchronize the inventory availability information from DOM to 
WebSphere Commerce. This service can be invoked by DOM directly, which 
does not need a message transformation. 

Upon every SyncInventoryAvailability service messages received, WebSphere 
Commerce updates its local DOM inventory cache. The distributed object 
memory cache or the database cache will be updated based on the 
configuration. 

SyncOrder/ConfirmBOD is used by the SyncOrder service to synchronize the 
order information from DOM to WebSphere Commerce. The DOM system can 
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invoke this service directly through the WebSphere Commerce SOA service 
client. Thus, transformation of messages is not needed. Every time that the order 
status is changed in the DOM system we recommend that you call this service to 
synchronize the updated order status to WebSphere Commerce. 

In Example 3-3, the DOM system used this message to synchronize the 
inventory availability of catalog entry ID 50400000173 and store ID 555. After this 
message, the local inventory cache of the inventory availability is updated to the 
available quantity of 135.0 and the available status. 

Example 3-3 SyncInventoryAvailability sample request message 

<_inv:SyncInventoryAvai labil ity rel easel D= "9.0" vers i on ID=" 7. 0.0.0" 
xml ns :_i nv="http://www. i bm. com/xml ns/prod/commerce/9/i nventory" 
xml ns :_wcf=" http://www.ibm.eom/xmlns/prod/commerce/9/foundat ion" 
xml ns :oa=" http: //www. openappl i cations.org/oagi s/9" 
xml ns :xsi = "http://www.w3.org/2001/XMLSchema-instance"> 

<oa:Appl icationArea xsi :type="_wcf : Appl icationAreaType"> 

<oa : Creat i onDateTime>2009-08- 12T07 : 16 : 54 . 2 18Z</oa : Creat i onDateT i me> 
<oa:B0DID>lccd80f0-8710-llde-9a77-841b4a826c66</oa:B0DID> 

<_wcf :BusinessContext> 

<_wcf :ContextData name="l angld">-l</_wcf :ContextData> 

<_wcf :ContextData name="storeId">555</_wcf :ContextData> 

</_wcf :BusinessContext> 

</oa: Appl i cat ionArea> 

<_inv:DataArea> 

<oa:Sync> 

<oa:ActionCriteria> 

<oa:ActionExpression act ionCode= "Change" 
expressionLanguage="_wcf :XPath">/InventoryAvai labil ity [l]</oa: Act ionExp 
ression> 

</oa : Acti onCri teri a> 

</oa:Sync> 

<_i nv : InventoryAvai 1 abi 1 i ty> 

<_i nv : InventoryAvai 1 abi 1 i tyldenti f i er> 

<_wcf: External Identifier 
<_wcf: Catalog Entry Identifier 
<_wcf : Uni quel D>50400000173</_wcf : Uni quel D> 

</_wcf :CatalogEntryIdentifier> 

<_wcf :0nl ineStoreldentifier 
<_wcf : Uni quel D>555</_wcf: Uni quel D> 

</_wcf:0nl ineStoreldentifier 
</_wcf: External Identifier 
</_i nv : InventoryAvai 1 abi 1 i tyldenti f i er 
<_inv: InventoryStatus>Avai lable</_inv: InventoryStatus> 

<_i nv : Avai 1 abi eQuanti ty uom="C62">135 . 0</_i nv : Avai 1 abi eQuanti ty> 
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<_i nv : Avai 1 abi 1 i tyDateTime>2008-08-08T13:36: 15.64Z</_i nv:Avai labi 1 ityDa 
teTime> 

<_i nv : Avai 1 abi 1 i tyOf f set>1000234</_i nv : Avai 1 abi 1 i tyOf f set> 

<_wcf :UserData> 

<_wcf :UserDataFi el d name="customFi el dl">8</_wcf :UserDataFi el d> 
<_wcf :UserDataField name="customField2">88</_wcf :UserDataField> 
<_wcf :UserDataField name="customField3">8-onl ine store 
f i el d3</_wcf : UserDataFi el d> 

</_wcf :UserData> 

</_i nv : InventoryAvai 1 abi 1 i ty> 


Note: There is one verb Sync and one noun InventoryAvailability in this BOD. 
Usually, there are different action codes for the verb. With these different 
action codes, a verb can take different actions on a noun. In this sample, Sync 
the InventoryAvailability with action code Change will try to update the 
InventoryAvailability in the local inventory cache. 


Example 3-4 is the confirmation message to DOM. The WebSphere Commerce 
side uses this message to inform DOM that the synchronization is complete. 

Example 3-4 Sample response message to SyncInventoryAvailability 
<oa:ConfirmBOD releaseID="9.0" 

xml ns :_wcf=" http://www.ibm.eom/xmlns/prod/commerce/9/foundat ion" 
xml ns :oa=" http: //www. openappl i cations.org/oagi s/9" 
xml ns :xsi = "http://www.w3.org/2001/XMLSchema-instance"> 

<oa:Appl icationArea xsi :type="_wcf : Appl icationAreaType"> 
<oa:CreationDateTime>2009-08-12T07:17:04.468Z</oa:CreationDateTime> 
<oa : BODI D>22e9aea0-87 10- 1 Ide-b60c-82804a812414</ oa : BODI D> 
</oa:ApplicationArea> 

<oa:DataArea> 

<oa:Confirm> 

<oa :0ri gi nal Appl i cati onArea> 
<oa:CreationDateTime>2009-08-12Z</oa:CreationDateTime> 

<oa: BODI D>lccd80f0-87 10- 1 lde-9a77-841b4a826c66</oa : BODI D> 
</oa:Original Appl icationArea> 

</oa:Confirm> 

<oa:B0D> 

<oa: Original Appl icationArea xsi :type="_wcf : Appl i cati onAreaType"> 
<oa:CreationDateTime>2009-08-12Z</oa:CreationDateTime> 

<oa: BODI D>lccd80f0-87 10- 1 lde-9a77-841b4a826c66</oa : BODI D> 

<_wcf :BusinessContext> 

<_wcf : ContextData name=" 1 ang Id ">- l</_wcf : ContextData> 

<_wcf :ContextData name="storeId">555</_wcf :ContextData> 


Chapter 3. Distributed order management integration 97 




</_wcf :BusinessContext> 
</oa:OriginalAppl icationArea> 
<oa:BODSuccessMessage/> 
</oa:BOD> 

</oa:DataArea> 

</oa:ConfirmBOD> 


Note: This simple ConfirmBOD message provides a confirmation message to 
the services consumer to indicate that the operation has completed 
successfully. 


3.2.6 Integration steps 

Generally, integrating the DOM integration solution requires the following steps: 

1 . Expose services or APIs to the DOM external system, for example 
WebSphere Commerce. In 3.3, “Implementation of WebSphere Message 
Broker mediation module for DOM integration” on page 98, we use a simple 
Web service as the DOM simulator. The DOM simulator supplies simple Web 
services for order management and inventory management with its owner 
format. 

2. Develop a message mediation module to do the transformation work between 
WebSphere Commerce messages and the DOM messages. 

3. Deploy the message mediation module in an enterprise service bus, for 
example, IBM WebSphere Message Broker or IBM WebSphere Enterprise 
Service Bus. 

4. Make configurations in WebSphere Commerce to communicate with the DOM 
system through the message mediation modules. 

For more detailed steps, refer to 3.3, “Implementation of WebSphere Message 

Broker mediation module for DOM integration” on page 98. 


3.3 Implementation of WebSphere Message Broker 
mediation module for DOM integration 

For this exercise, we use an external OMS simulator, which is a simple JEE 
application written to serve as a sample back-end system for DOM Integration 
purposes. It exposes a number of inventory and order operations as Web 
services. It does not perform any real processing when generating a response. It 
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instead returns standard or random results, depending on the case, to use as 
sample sets of data. 

You can find the EAR for the external OMS simulator and the installation steps in 
the Installing the external OMS simulator topic in the WebSphere Commerce 
Version 7 Information Center. 


3.3.1 Installation 

We must install WebSphere Message Broker toolkit, WebSphere Message 
Broker run time, WebSphere MQ server, and DB2 Universal Database. For 
installation of these products, refer to the product documentation and manuals. 

3.3.2 Post-installation tasks 

After a full installation of WebSphere Message Broker (both the toolkit and the 
run time), ensure that WebSphere MQ and DB2 are running using the steps that 
we describe in this section. 

WebSphere MQ service 

To verify that the WebSphere MQ service is running, perform one of the following 
tasks: 

► Check the MQ system tray icon (||) to see whether WebSphere MQ is 
running. The green up arrow shows that the system tray icon for WebSphere 
MQ is in the started state. If WebSphere MQ is not running, right-click the 
system tray icon, and then click Start WebSphere MQ. 

► Check the Services list for the IBM MQSeries® status. The status should be 
Started. To open Services, click Start 0 Control Panel 0 Administrative 
Tools 0 Services. If WebSphere MQ is not running in the Services window, 
right-click IBM MQSeries, and then click Start. 

DB2 Universal Database 

To verify that DB2 Universal Database is running, perform one of the following 
tasks: 

► Check the system tray icon (Q|) to see whether DB2 Universal Database is 
running. The green color indicates that the system tray icon for DB2 Universal 
Database is in the started state. If DB2 Universal Database is not running, 
right-click the system tray icon, and then click Start (DB2). 

► At a command prompt type db2start. If DB2 Universal Database is running, 
the following message displays: 

The database manager is already active 
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If DB2 Universal Database is not running, issuing the db2start command to 
start DB2 Universal Database. 

► Check Services for the status of the DB2 - DB2-0 service, which should be 
Started. To open Services, click Start 0 Control Panel 0 Administrative 
Tools 0 Services. If DB2 is not running (no status is displayed), in the 
Services window, right-click DB2 - DB2-0, and then click Start. 


3.3.3 Create default configuration for WebSphere Message Broker 

To run any application on WebSphere Message Broker, it must configure the 
runtime components and create a broker domain. The WebSphere Message 
Broker default configuration wizard creates the following components and 
resources to provide a simple broker domain for testing the applications: 

► A Configuration Manager called 
WBRK6_DEFAULT_CONFIGURATION_MANAGER 

► A broker called WBRK6_DEFAULT_BROKER 

► A queue manager called WBRK6_DEFAULT_QUEUE_MANAGER, shared by 
the Configuration Manager and the broker 

► A listener on the queue manager on port 2414 

► A broker database called DEFBKDB6 


Note: An explanation and discussion of these components of WebSphere 
Message Broker is out of scope of this book. For more information, refer to 
WebSphere Message Broker Basics, SG24-7137. 
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Steps to run the default configuration wizard 

To run the default configuration wizard: 

1 . Open the WebSphere Message Broker Toolkit. If the WebSphere Message 
Broker Welcome window does not display, click Help 0 Welcome. 

2. Click the Get Started icon shown in Figure 3-5. The Getting Started page of 
the Welcome window opens. 



Get Started 

Get started with 
WebSphere Message 
Broker; create the Default 
Configuration, then verify 
your installation using the 
Pager samples 

Figure 3-5 Get Started 

3. Click the Create the Default Configuration icon (Figure 3-6). The Create the 
Default Configuration topic in the product documentation opens in the 
WebSphere Message Broker Toolkit help system. 


Create the Default Configuration 

The Default Configuration is a simple broker domain that 
includes a broker and a Configuration Manager and all the 
resources that they need. 


Figure 3-6 Create the Default Configuration 

4. Click the Start the Default Configuration wizard link to start the wizard. 

When the Default Configuration wizard has completed successfully, a simple 
broker domain is configured on the system. The connection to the broker domain 
is displayed in the Broker Administration perspective. 
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3.3.4 Creating mediation module in WebSphere Message Broker 


This section explains the implementation of the mediation module for the 
Reservelnventory Outbound message (refer to 3.2.4, “DOM integration outbound 
messages” on page 91). 

Creating new mediation module project 

To create a new mediation module project named SampleDOMMediation: 

1 . In the WebSphere Message Broker toolkit switch to the Broker Application 
Development Perspective. 

Note: Verify that Build Automatically is turned on for the WebSphere 
Message Broker toolkit by navigating to the Project menu on the top menu 
bar. 

2. Click Start from WSDL and/or XSD files (Figure 3-7). 


Start from scratch 

L H' Start from WSDL and/or XSD files 
Ej| Start from existing message set 
fesf Start from adapter connection 


Figure 3-7 Launch 


3. The New Message Broker Application window opens. Enter the values shown 
in Table 3-1 and in Figure 3-8, and click Next. 

Table 3- 1 Mediation module properties 


Property 

Value 

Message flow project name 

SampleDOMMediation 

Message set project name 

Sampl eDOMMedi ati onMessageSet 

Message set name 

Sampl eDOMMedi ati onMessageSet 

Message flow name 

Sampl eDOMMedi ati onFl ow 

Working set name 

SampleDOMMediation 
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Figure 3-8 New Message Broker Application 
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4. On the Resource selection screen, select the “Use external resources” option. 
Browse to the location of WSDL. For our example, we import the following 
WSDL: 

InventoryServices.wsdl located in <WCDE install 
di r>/workspace/WebServi cesRouter/WebContent/component-servi ces/wsdl 
Refer to Figure 3-9 for details. 



Figure 3-9 Resource Selection 
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5. Click Next to get the Binding Selection window (Figure 3-10). Click Finish. 



Figure 3-10 Binding Selection 
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After you click Finish, your toolkit window looks like Figure 3-1 1 . 



Figure 3- 1 1 Mediation flow 
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6. Next, you import WSDL for the External OMS simulator. Repeat step 1 on 
page 102 through step 4 on page 104, and use the values shown in Table 3-2 
and Figure 3-12 on page 107, Figure 3-13 on page 108, Figure 3-14 on 
page 109, and Figure 3-15 on page 110. 

Table 3-2 Message set properties 


Property 

Value 

Message flow project name 

SampleExtOMS 

Message set project name 

Sampl eExtOMSMessageSet 

Message set name 

Sampl eExtOMSMessageSet 



Figure 3- 12 New Message Broker Application 
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Figure 3-13 Resource Selection 
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Figure 3-14 Binding Selection 
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0fe5 SampleDOMMediation ) 

0 SampieDOMMediationMessageSet 
B & SampleExtOMS 
; W Flows 

0 i§ SampleExtOMSMessageSet 
01^ SampleExtOMSMessageSet 
i Cl messageSet.mset 
i Deployable WSDL 

j 0 8& test 

1 ® ExtOMSSim.wsdl 
| 0 ® Message Definitions 

0~6& (default namespace) 

0 • ® org.xmlsoap.schemas.soap.envelope 
0® test 
0 log 
0' & test 

□ ExtOMSSim.wsdl.report.txt 


Figure 3-15 SampleDOMMediation 

Implementing the mediation flow 

After creating the mediation module project, you can implement the message 
flow for the Reservelnventory service as follows: 

1 . Open SampleDOMMediationFlow.msgflow in the editor. 

2. Expand the SampieDOMMediationMessageSet node until you get to 

InventoryServices.wsdl (Figure 3-16). 


B $3 SampleDOMMediation 
| 0 US Flows 

0 ® (default broker schema) 

1 US SampleDOMMediationFlow.msgflow 
0 £§ SampieDOMMediationMessageSet 
3 SampieDOMMediationMessageSet 

i i 1 messageSet.mset 

i □ 3 Deployable WSDL 

0 - S com.ibm.www.xmlns.prod.commerce._9.inventory 
[)f InventoryServices.wsdl 
0 0 Message Definitions 
0 & log 

0 l£ SampleExtOMS 
0 SampleExtOMSMessageSet 


Figure 3-16 InventoryServices.wsdl 
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3. Drag InventoryServices.wsdl into the SampleDOMMediationFlow.msgflow 
editor. When you drop the WSDL in the editor, it asks for Web service usage 
configuration. Configure it as shown in Figure 3-17, and click Next. 



Figure 3-17 Configure Web service usage 
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4. On the next window, select HTTP nodes, and click Finish (Figure 3-18). 



Figure 3-18 Row Generation Details 
5. The message flow displays similar to Figure 3-1 9. 


fc 6 — 

HTTP Input InventoryServices 


► f 


SOAPEnvelope 

1 <?'l 

fiTTP Reply) 


Figure 3-19 Message flow 
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6. Double-click InventoryServices subflow, and it looks similar to Figure 3-20. 


B *■& K31 


m 

ProcessInventoryRequirement 


10 hLlI 

ws_SyncInventoryAvailability SyncInventoryAvailability 


to «| 1! 

ws_GetInventoryAvailability GetlnventoryAvailability 

*=■ H3 

wsjZhangelnventoryAvailabilityChangelnventoryAvailability 


Figure 3-20 Message flow after InventoryServices selected 


7. In Figure 3-19, select HTTP Input node, and modify the properties in 
properties pane. Set the Path suffix for URL as 
http://ZocaZ/?os£:7080/InventoryService/processInventory, where 
localhost:7080 is the host name and port where you want to publish this Web 
service. 

8. In Figure 3-20, in InventoryServices 
subflow(lnventoryServices_SampleDOMMediationFlow.msgflow), rename the 
in node as InventoryRequest. Refer to Figure 3-21. 
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9. Expand SampleExtOMSMessageSet Project in the navigator window and 
navigate to ExtOMSSim.wsdl . Drag this WSDL into 

SampleDOMMediationFlow.msgflow. Configure the Web service properties 
as shown in Figure 3-22. 



Figure 3-22 Configure Web service usage 
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lO.CIick Next and select HTTP nodes on the next window. Click Finish. A 
subflow getlnventory_ExtOMSSim is added to 
SampleDOMMediationFlow.msgflow (Figure 3-23). 



1 1 .Set the Web service URL property for the request node to the URL of the 
external OMS simulator service. In our case, it is 

http: //local host:9980/Ext0MSSimWeb/services/Ext0MSSim (Figure 3-24). 



Figure 3-24 SOAP Request Node Properties - Request 


116 


Building Multichannel Applications with WebSphere Commerce 


Implementing the transformation nodes 

There are multiple ways of transforming the messages. It can be done using the 
mapping node, Java compute node, or XSL transformation. For our example, we 
have chosen XSL transformation as the way to transform the messages. The 
mediation flow must transform the input message ProcessInventoryRequirement 
to the message updatelnventoryReservations and output message 
updatelnventoryReservationsResponse to the message 
AcknowledgelnventoryRequirement. 

To create the transformation nodes: 

1 . Create a new XSL. Click File 0 New 0 Other 0 XSL. Enter the name of the 
parent folder as Sampl eDOMMedi ati on and the file name as 
Process I nventoryReqmtJJpdatelnventoryReservationsReq.xsl 
(Figure 3-25). Click Finish. 



Figure 3-25 New XSL File 
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2. Add an XSL Transform node from the palette to SampleDOMMediationFlow. 
Rename the node to 

Process I nventoryReqmtToUpdatelnventoryReservationsReq. Modify the 
properties of this node and set the stylesheet name to 
ProcessInventoryReqmtJJpdatelnventoryReservationsReq.xsl . Set Output 
Message Parsing properties as shown in Figure 3-26. 



Figure 3-26 XSL Transform Node Properties 


3. Implement the XSL 

ProcesslnventoryReqmt_UpdatelnventoryReservationsReq.xsl. This XSL 
transforms the ProcessinventoryRequirement message to 
updatelnventoryReservations message. The sample XSL is given in A.9, 
“ProcesslnventoryReqmt_Updatelnventory ReservationsReq.xsl” on 
page 477. 
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4. In SampleDOMMediationFlow connect the OUT terminal of the 
InventoryServices node to IN terminal of the 

ProcessInventoryReqmtToUpdatelnventoryReservationsReq node. When you 
click the OUT terminal of the InventoryServices node, you will get a Terminal 
Selection window. Select ProcessInventoryRequirement. Refer to 
Figure 3-27. 



Figure 3-27 Terminal Selection 
5. Connect the OUT terminal of 

ProcessInventoryReqmtToUpdatelnventoryReservationsReq to the IN 
terminal of the getlnventory_ExtOMSSim node. 
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6. Create another XSL, as done in step 1 on page 117. Name the XSL 

UpdateInventoryReservationsResp_AcknowledgeInventoryReqmt.xsl . Add 
another XSL Transform node to the message flow as in step 2 on page 1 1 8. 
Rename the node 

UpdatelnventoryReservationsRespToAcknowledgelnventoryReqmt. Modify the 
properties of this node and set the stylesheet name to 
UpdateInventoryReservationsResp_AcknowledgeInventoryReqmt.xsl . Set 
the Output Message Parsing properties as shown in Figure 3-28. 



Figure 3-28 XSL Transform Node Properties 


7. Implement the XSL 

UpdatelnventoryReservationsResp_AcknowledgelnventoryReqmt.xsl. This 
XSL transforms the updatelnventoryReservationsResponse message to the 
AcknowledgelnventoryRequirement message. A sample implementation of 
XSL is given in A.10, “UpdatelnventoryReservationsResp_ 
AcknowledgelnventoryReqmt.xsl” on page 480. 
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8. In SampleDOMMediationFlow connect the OUT terminal of the 
getlnventory_ExtOMSSim node to the IN terminal of 
UpdatelnventoryReservationsRespToAcknowledgelnventoryReqmt and the 
OUT terminal of 

UpdatelnventoryReservationsRespToAcknowledgelnventoryReqmt to the IN 
terminal of the SOAPEnvelope node. Refer to Figure 3-29. 



9. In the properties window for the SOAPEnvelope node, select the Create New 
Envelope check box. 
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3.3.5 Deploying mediation module 


Before starting the deployment process, we must connect the configuration 
manager (WBRK61_DEFAULT_CONFIGURATION_MANAGER). To connect, 
right-click WBRK61_DEFAULT_CONFIGURATION_MANAGER in the Domains 
navigator, and select Connect. 

1 . Switch to the Broker Administration perspective. 

2. Create a New broker archive, SampleDOMWCS.bar (Figure 3-30): 

a. Go to File 0 New 0 Message Broker Archive. 

b. Select the project as LocalProject. 

c. Enter the name Sampl eDOMWCS . bar. Click Finish. 



Figure 3-30 Message Broker Archive 

3. Open SampleDOMWCS.bar in the editor. Select SampleDOMMediation in Filter 
Working Set. Select the options as shown in Figure 3-32 on page 124, and 
click Build broker archive. 
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4. Create a Execution Group, SampleDOMWCS. 

a. Go to File 0 New 0 Execution Group. 

b. Select WBRK61_DEFAULT_BROKER and for the Execution Group name 
enter Sampl eDOMWCS. Click Finish. Refer to Figure 3-31 . 



Figure 3-31 Create an Execution Group 
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5. Right-click SampleDOMWCS.bar in the Broker Administration Navigator, and 
click Deploy File. Select SampleDOMWCS as the execution group. See 
Figure 3-32. 


t i SampleDOMMediatio.. . [ B updatelnventoryRe. . . [ B Pro cessInventoryR... | 0 UpdatelnventoryRe... 


Prepare 

Select workspace deployable resources to build within the broker archive 


The tree below displays all of the deployable artifacts within the workspace. 
Filter working set: |SampleDOMMediation _*} | type filter text 


Message Flows 

: ■ 0 0S SampleDOMMediationFlow.msgflow - /SampleDOMMediation/SampleDOMMediationFlow.msgflow 
S-0I& Message Sets 

0 messageSet.mset - /SampleDOMMediationMessageSet/SampleDOMMediationMessageSet/messageSet.mset 
1 0^1 messageSet.mset - /SampleExtOMSMessageSet/SampleExtOMSMessageSet/messageSet.mset 
- 0£§XSLT 

i 0 B ProcessInventoryReqmt_UpdateInventoryReservationsReq.xsl - /SampleDOMMediation/ProcessInventoryReqmtJJpdatelnventoryReservationsRe 
0 B UpdateInventoryReservationsResp_AcknowledgeInventoryReqmt.xsl - /SampleDOMMediation/UpdateInventoryReservationsResp_AcknowledgeIn‘ 

□ Qy Java* 

□ Adapters 
: U& PHP 


(*)-A resource marked with * will be added automatically to the Broker Archive if a message flow that references it is added to the Broker Archive. 

Build options 

0 Remove contents of Broker Archive before building. 

0 Override configurable property values 


ild broker archive 


Prepare \ Manage User Log Service Log 


Figure 3-32 Prepare 
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6. After the broker archive deploys, right-click SampleDOMMediationFlow in 
the Domains navigation window, and click Start (Figure 3-33). 



Figure 3-33 Broker Administrator 
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3.4 Implementing WebSphere Enterprise Service Bus 
mediation module for DOM integration 

You can also perform the implementation steps that are explained in 3.3, 
“Implementation of WebSphere Message Broker mediation module for DOM 
integration” on page 98 using WebSphere Enterprise Service Bus and 
WebSphere Integration Developer. For a detailed step-by-step process and 
sample code, refer to the Building a WebSphere Enterprise Service Bus 
mediation module for DOM Integration topic in the WebSphere Commerce 
Version 7 Information Center: 

http : //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?topic= 
/com . i bm . commerce . dom-i ntegrat i on . doc/tas ks/tsmdombui 1 dmedmod . htm 


3.5 Configuring the DOM integration feature 

You must make integration changes in WebSphere Commerce to integrate with 
the mediation module that was developed in 3.3, “Implementation of WebSphere 
Message Broker mediation module for DOM integration” on page 98, which in 
turn integrates with External DOM simulator. 

To configure the DOM integration feature: 

1 . Start the WebSphere Commerce server. 

2. Open the Administration console. 

3. On the Site/Store Selection page, select Site. 

4. Select Configuration 0 Transports. 

5. Click Add. 

6. Select Web Services (HTTP). 

7. Click Add. 

8. Select Configuration 0 Message Types. 

9. Create the message type configuration listed in Table 3-3. 


Table 3-3 Message types 


Property 

Value 

Message type 

com.ibm.commerce.inventory.external 

Transport 

WebServices (HTTP) 


126 


Building Multichannel Applications with WebSphere Commerce 


Property 

Value 

Device Format 

webservices 

URL 

http://localhost:7080/lnventoryService/processlnventory 


10. Close the Administration Console. 

1 1 .Connect to the database. 

12. Execute the following SQL statement to use an external system for inventory 
and order processing: 

UPDATE STORE SET INVENT0RYSYSTEM=-5 WHERE STOREJD IN (SELECT 
STOREENT_ID FROM STOREENT WHERE IDENTIFIER='Store_Identifier' ); 
Where Store_Identifier is the value of your store identifier. For 
example, 'Madisons' for your consumer direct store. 

13. Replace the contents of the wc-component-cl ient.xml file in 
workspace_di r/wc/xml /conf i g/com . i bm . commerce . i nventory . external / wc-c 
omponent-cl ient.xml with the contents in Example 3-5. 

Example 3-5 The wc-component-client.xml file 

<?xml version="1.0" encodi ng="UTF-8"?> 

<_conf i g : Devel opmentCl i entConf i gurati on 

xml ns :_config=" http: //www. ibm.com/xml ns/prod/commerce/foundat ion/con 
fig" xml ns :xsi = "http: //www. w3.org/2001/XMLSchema-instance" 
xsi :schemaLocation=" http: //www. ibm.com/xml ns/prod/commerce/foundat io 
n/config . ./xsd/wc-component-cl ient.xsd"> 

<_conf i g : i nvocati onservi ce> 

<_conf i g : i nvocati onbi ndi ng 

bi ndi nglmpl ="com. i bm. commerce . foundati on . i nternal . cl i ent . servi 
ces . i nvocati on . impl . JCAInvocati onBi ndi nglmpl "></_conf i g : i nvoca 
tionbinding> 

<_config:action name="GetInventoryAvai labi 1 ity" 
asynchronous="fal se"></_conf i g : acti on> 

<_config:action name= "Process I nventoryRequi rement" 
asynchronous="fal se"></_conf i g : acti on> 

</_conf i g : i nvocati onservi ce> 

</_conf i g : Devel opmentCl i entConf i gurati on> 


14. Restart the WebSphere Commerce server. 

After completing the steps in 3.3, “Implementation of WebSphere Message 
Broker mediation module for DOM integration” on page 98, and 3.5, “Configuring 
the DOM integration feature” on page 126, browse to the Madisons Starter Store 
product pages, and add items to the cart. When you try to check out from the 
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cart, a call is made to the ProcessInventoryRequirement outbound service with 
the action code Reservelnventory. 


Because we implemented the Reservelnventory flow in WebSphere Message 
Broker, the External OMS simulator is invoked and a response with allocated 
inventory is returned. Refer to the following sections: 

► A.1 , “ProcessInventoryRequirement with action code Reservelnventory 
request” on page 456, for a sample request 

► A.2, “ProcessInventoryRequirement with action code Reservelnventory 
response” on page 460, for a sample response 
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Web 2.0 storefront 


This chapter describes the Madisons Starter Store (Web 2.0 storefront) and 
explains how to integrate MapQuest with the Store Locator feature in IBM 
WebSphere Commerce V7. 

This chapter includes the following topics: 

► WebSphere Commerce Web 2.0 store overview 

► Buy online, pick up in store 

► The Store Locator feature 

► MapQuest integration for Store Locator 

► MapQuest Geocoding 


© Copyright IBM Corp. 2010. All rights reserved. 
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4.1 WebSphere Commerce Web 2.0 store overview 


IBM WebSphere Commerce V7 supplies two Web 2.0 sample starter stores: 

► The Madisons Starter Store, a business-to-consumer model 

► The Elite starter store, a business-to-business model 

Both of these sample stores include features that shoppers might want, for 
example placing orders by drag, fast finder with slide bars for product attributes, 
and so forth. 

These stores support both distributed order management (referred to as DOM 
throughout this book) integration solution and buy online, pick up in store 
(referred to as BOPIS in this book). 


4.1.1 Web 2.0 in WebSphere Commerce 

Web 2.0 introduces Web features other than Web 1 .0. WebSphere Commerce 
exploits these features in Web 2.0 starter stores to attract more customers to the 
storefront so that more orders are placed in the Web 2.0 store. 

WebSphere Commerce uses the Dojo Ajax and events API to provide a 
framework that meets all the Ajax requirements for storefront development. For 
more information about Dojo framework, refer to: 
http : //www. dojotool kit.org/docs 

IBM WebSphere Commerce V7 extends the Dojo framework by providing the 
following APIs and widgets: 

► APIs 

- wc. service. declare (initProperties) 

This function declares a new Ajax service with the specified ID. A service 
is a server URL that performs a server object create, update, delete or 
other server processing in WebSphere Commerce. By using this API, you 
will have the capability to call a WebSphere Commerce server URL using 
Ajax whenever it is needed in your JavaScript code. 

- wc. service. invoke (serviceld, parameters) 

This function finds the registered service with the specified service ID and 
invokes the service through Ajax using the specified parameters. 
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- wc. service. getServiceByld (serviceld) 

This function gets the service that was declared under the specified 
identifier. If the service was not declared then this function will return 
"undefined". 

- wc . render . decl areRef reshControl 1 er (i ni tProperti es) 

This function declares a new refresh controller and initializes it with the 
specified initialization properties. The initialization properties are “mixed 
in” with the new refresh controller’s properties. 

A refresh controller controls refresh area widgets. It listens to changes in 
the render context and changes to the model and decides if the registered 
refresh areas should be updated. 

- wc. render. getRefreshControl lerByld (ID) 

This function returns the refresh controller that was declared under the 
specified identifier. If the refresh controller was not declared then this 
function will return "undefined". 

- wc. render. decl areContext (ID, properties, updateContextURL) 

This function declares a new render context and initializes it with the 
specified render context properties. The update context URL is used to 
report changes to the render context to the server. 

- wc. render. getContextByld (ID) 

Get the render context that was declared under the specified identifier. If 
the render context is not declared, then this function returns undefined. 

- wc. render. updateContext (ID, updates) 

This function retrieves the render context with the specified ID and applies 
the updates found in the specified updates object. 

Widgets 

- wc. widget. RefreshArea 

The refresh area widget is used to wrap a DOM node that might need to 
be refreshed by replacing the innerHTML property with fresh HTML loaded 
from the server. A refresh area widget is associated with a registered 
refresh controller that handles listening for events that will require this 
widget to be refreshed. 

- wc. widget. RangeSl ider 

This widget is a widget that defines a two handle slider which can be used 
to drive a price range selection in the storefront. It is being used in the fast 
finder page. 
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- wc. widget. Scrol 1 abl ePane 

A scrolling thumbnail picker widget that can accept any content and it can 
scroll these content. The ScrollablePane is the widget which provides 
scrolling effect for the items or images which is part of the content inside 
the widget. Each item in the scrollable should be in side a ContentPane 
widget. User can scroll the items manually as well as auto. By passing the 
autoScroll paramenter as true items will scroll automatically. There are two 
basic control buttons to allow users to manually scroll the contents left and 
right as desired. 

The Madisons starter store uses these Web 2.0 APIs. You can use the Madisons 
Starter Store as the base store for a customized Web 2.0 store. For more 
information, refer to 4.1 .2, “Madisons Starter Store” on page 132. 

For more information about WebSphere Commerce Web 2.0 technology, refer to 
WebSphere Commerce Best Practices in Web 2.0 Store, SG24-7647. 

4.1 .2 Madisons Starter Store 

The Web 2.0 Madisons Starter Store is enhanced in IBM WebSphere Commerce 
V7. For more detailed information about these enhancements, refer to 2.1 , 
“Enhanced Madisons Starter Store” on page 30. 

As mentioned in “New Change Flow options” on page 40, the Web 2.0 features in 
Madisons Starter Store are configurable. The store administrators can enable or 
disable the Web 2.0 features in the WebSphere Commerce Accelerator tool. 

To enable the Web 2.0 feature Product drag, you need to first enable the 
Compare zone and Mini shopping cart feature. 
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Figure 4-1 illustrates how to enable the Compare zone feature. You access these 
enablement options by selecting Store 0 Change Flow from the menu, and 
clicking Catalog in the notebook. 



Figure 4-1 Enable compare zone in WebSphere Commerce Accelerator 
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Figure 4-2 shows how to enable the mini shopping cart page in WebSphere 
Commerce Accelerator. You can access these enablement options by selecting 
Store 0 Change Flow from the menu, and clicking Orders in the notebook. 



Figure 4-2 Enable mini shopping cart in WebSphere Commerce Accelerator 


4.2 Buy online, pick up in store 

In this book, we use the term BOPIS to represent buy online, pick up in store. 
The BOPIS feature ships with the IBM WebSphere Commerce V6 Feature 
Enhancement Pack 5, which supports the DOM inventory. With IBM WebSphere 
Commerce V7, the BOPIS feature is enhanced to support all the inventory 
systems in WebSphere Commerce, including available to promise (ATP) 
inventory, non-ATP inventory, and DOM. 
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4.2.1 BOPIS overview 


In IBM WebSphere Commerce V6 Feature Enhancement Pack 5, the DOM 
feature must be enabled to use the BOPIS. For information about how to enable 
the DOM feature in Feature Enhancement Pack 5, refer to: 
http : //publ i b.boul der.i bm.com/ i nfocenter/wchel p/v6r0m0/index. jsp?topi c= 
/com. ibm. commerce. dom-integrati on. doc/tasks/tsmbopi si nstal l_dup.htm 

In IBM WebSphere Commerce V7, BOPIS is a base feature of the Madisons 
Starter Store and the Elite starter store without extra installation and 
configuration steps. 

BOPIS enables shoppers to browse the online category. When the shopper 
check out the items, instead of asking the online store to ship the items, the 
shopper can select a physical store and pick up the items from there. 

BOPIS also provides more choices for payment method when checking out. The 
shoppers can pay online or can choose to pay in store when they pickup the 
merchandise. 

By selecting pickup in store, shoppers can save shipping costs that are 
associated with a delivery and can choose a time that is convenient to pick up the 
merchandise rather than having to wait for a delivery. Shoppers can choose a 
physical store that is convenient for pickup. 

By enabling BOPIS, the retailer provides this convenience option to shoppers, 
which also has the benefit of shoppers physically visiting a brick-and-mortar 
store, where additional purchases can take place. 

4.2.2 BOPIS in Madisons Starter Store 

In a typical end-to-end BOPIS scenario, an online shopper takes the following 
general steps to complete the shopping process: 

1 . The online shopper browses the product catalog online. 

2. The online shopper adds a product into the Shopping Cart and checks out. 

3. When checking out, the online shopper chooses to pick up the product in the 
store instead of shipping the product. 

4. When the online shopper selects the pick up in store option, there are options 
for payment, including pay in the store. 

5. The online shopper submits the order. 

6. The online shopper goes to the store and pays for the merchandise and picks 
up the merchandise in store. 
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Here is a more detailed explanation of each step regarding this end-to-end 
scenario: 

1 . The online shopper browses the categories. 

The online shopper goes to the Madisons Starter Store storefront and does 
some browsing. The shopper is interested in the lounge chairs in the furniture 
category and clicks the lounge chairs category for more detailed information. 
Then, the products in the lounge chairs category are listed as shown in 
Figure 4-3. 


Displaying products 1 

- 4 of 4 


White Fabric Roll Arm 


i White Wing Chair Contemporary 

Upholstered Armchair 

$449.99 

$649.99 

$499.99 $479.99 

Displaying products 1 

- 4 of 4 



Figure 4-3 Products of lounge chairs category listed 


Note: The online shopper can click the icons in the top, right of the page to 
change how these products are listed. They can be listed by details or in a 
table. 


In this page, the shopper can click Add to Cart to add one item into the 
Shopping Cart. However, this page does not display detailed information 
about the product. 

When browsing the products, the online shopper can complete the following 
tasks: 

a. The online shopper selects to view quick information. 

When the online shopper moves the mouse pointer over the item, a 
window opens that includes the Quick Info button. The shopper clicks this 
button to view the quick information about this product. 
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The quick information window offers more options to the shopper, as 
shown in Figure 4-4. From this window, the online shopper can choose 
Add to Cart, Add to Wish List, or Add to Compare. 
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b. The online shopper views the product detail page. 

To get more information, the online shopper clicks the more info link to 
view the product details page. The shopper can also choose to close this 
window first and then click the product icon. In either case, the shopper is 
directed to the product detail page in Figure 4-5. 



In this example, the shopper can view more detailed information about this 
white fabric roll arm chair. There are detailed descriptions of this chair in 
the Description tab. In addition, any attachments for this chair, such as 
more pictures, display in the Attachments tab. 

In the Check Store Availability area, by default, the inventory availability of 
the online store displays. In this scenario, the chair is in stock, 
c. The online shopper adds more stores. 

The shopper now can click Show Availability for the in-store availability. If 
the shopper did not select any favorite store before, the page is redirected 
to the Store Locator page, where the shopper can select favorite stores. 
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In the top half of the Store Locator page, the favorite stores previously 
selected by the shopper display, as shown in Figure 4-6. The shopper can 
click the Remove button to remove some of them from the favorite store 
list. 


Check availability at a store near you 



White Fabric Roll Arm Chaise 
Price: $449.99 

Your Store List 



STORE NAME AND ADDRESS 

HOURS 


Calgary Circle Mall 

300 MacLeod Tr 
Calgary, Alberta T2G 5R1 

Mon-Fri: 10am - 9pm 
Suns 11am - 6pm 

X Remove 

Calgary Mall 

1025 Cameron Aue SW 
Calgary, Alberta T2T 0K4 
367.S66.6S6S 

Mon-Frh 10am - 9pm 
Sat: 9am - 7pm 
Suns 11am - 6pm 

""" 

Figure 4-6 The store list in Store Locator top half page 



Chapter 4. Web 2.0 storefront 1 39 


In the bottom half of the Store Locator page, the shopper can add more 
stores to their favorite store list, as shown in Figure 4-7. 



The shopper can select the country, state, and city and click Go to find a 
store list in this area. Clicking the Add to store list button adds the store 
to the store list. 

In this scenario, the shopper adds Breakfast Place and Winnipeg Mall into 
the favorite store list. 

d. The online shopper selects to show the inventory availability. 

By clicking Continue Shopping, the shopper goes back to the product 
detail page. Then, when the shopper clicks Show availability, the 
inventory availability of the stores displays in the store list, as shown in 
Figure 4-8. In this sample, there are sufficient inventories in Calgary Mall 
and Calgary Circle Mall, but the item is out-of-stock in Breakfast Place and 
Winnipeg Mall. 
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Figure 4-8 Product detail page: Show store inventory availability 


2. The online shopper adds the product to the Shopping Cart. 

The online shopper clicks the Add to Cart button, and the product is added 
successfully into the shopper’s shopping cart. Then, the following message 
displays in the product detail page to indicate to the shopper that the 
operation is successful: 

The item has been successfully added to your shopping cart. 

Note: Because we enabled the Ajax add to shopping cart feature for the 
Madisons Starter Store, the online shopper added successfully the product 
into the Shopping Cart without leaving the product detail page. 
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Now the Shopping Cart icon in the top, right shows one item. When he 
shopper moves the mouse pointer over the item, the mini shopping cart 
pop-up window displays, as shown in Figure 4-9. 


Home | Shopping Cert | A 

HR Search QJ 

advanced Search | Store Locator | Sign In 

United St 

'jrn Chaise 


U&ffil 


1— II — 1 


Figure 4-9 The mini shopping cart window 


3. The online shopper checks out and chooses to pick up the product in the 
store instead of shipping the product. 

The online shopper clicks the Checkout button and goes to the Shopping 
Cart page to check out, as shown in Figure 4-10. In this page, the shopper 
can select to continue shopping online or to pick up at store. The shopper can 
also use this page to update the item quantity or to remove the items. There is 
also an option for the shopper to input promotion codes. 



Figure 4-10 Select Pick Up at Store 
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In this scenario, the shopper selects the “Pick Up at Store” option. 

If the shopper did not log on to the store yet, log on options display in the 
same page, as shown in Figure 4-1 1 . 



If the shopper is a registered customer in this store, the shopper can enter a 
user name and password and then click Sign in & Checkout. 
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4. The online shopper selects a store to pick up and a payment option. 

In this scenario, the shopper clicks Continue Checkout as a guest shopper. 
Then, the online shopper selects a store and payment option as follows: 
a. The store selection page displays so that the online shopper can choose a 
store in which to pick up the merchandise. For the four favorite stores 
listed, the shopper selects Calgary Mall, as showed in Figure 4-12, and 
clicks Continue to continue with checkout process. 
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b. The online shopper selects Pay in-store. 

On the address page, the shopper can choose whether to pay for the 
merchandise in store. If the pay in store option is not selected, the shopper 
must input a billing address. The shopper selects Pay in-store as shown 
in Figure 4-13, and clicks Next. 



Figure 4-13 Store address and pay in-store selection 
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c. The online shopper goes to the shipping and billing page, shown in 
Figure 4-14. 

Now the online shopper goes to the shipping and billing page, which 
displays the address of the Calgary mall. At this point, the shopper can still 
change the store when needed by clicking the Change Store button, 
which directs the shopper back to the store selection page. 

This page also displays that the pay in store option is selected for the 
payment method. To change the payment option, the online shopper 
needs to click Change button in the Payment Information section to go 
back to the address page. 

If all the information is correct, the online shopper clicks Next to proceed. 
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d. A summary of the current order displays in this page, as shown in 
Figure 4-15. 



Figure 4-15 Order summary 

Because the shopper continues the checkout as a guest shopper, the 
store needs the shopper’s e-mail address to send an order confirmation 
and to inform the shopper when the merchandise will be ready to be 
picked up. 

This page also supplies an option to send the shopper a Short Message 
Service (SMS) message for order confirmation. It is optional. 

The online shopper enters an e-mail address and a mobile phone number. 


Note: The shopper must enter a valid e-mail address here to check out 
as a guest shopper. For a registered shopper who has logged on to the 
store, the shopper is not prompted to input an e-mail address. The 
e-mail address in the registration profile is used. 
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5. The online shopper submits the order. 

After entering an e-mail address and mobile phone number, the online 
shopper clicks the Order button to submit the order, as shown in Figure 4-16. 



Figure 4-16 Order submission 

When the order placed successfully, the order confirmation page displays, as 
shown in Figure 4-17. On this page, the shopper can view the order number, 
the order submission date, and a summary of the order for the pickup address 
and billing address. 

It is highly recommended that the shopper to print this page, because in-store 
personnel might ask for this information when the shopper picks up the 
merchandise in the store. 

Sometime later, the store sends a confirmation e-mail to the shopper about 
this order. If the shopper input a mobile phone number, an SMS order 
confirmation message is also sent to the shopper. 

When picking up the merchandise, in-store personnel might ask the shopper 
to show the e-mail confirmation letter or the SMS message. It depends on the 
merchant’s choice. 
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4.3 The Store Locator feature 


IBM WebSphere Commerce provides a simple API to enhance the Store Locator 
functionality. You can customize the Store Locator to integrate with map service 
providers, providing enhanced searching and displaying capabilities on the Store 
Locator page. 

Integrating with map service providers provides the following enhancements: 

► Store locations can be found by entering a Zip or postal code into the search 
fields. This advanced level of location searching enables the customer to find 
stores relative to any location of their choice. 

► A map of the area can be displayed on the Store Locator page, where the 
store locations are labelled on the map. Multiple store locations labelled on 
the map enable the customer to quickly locate the most convenient store 
location. 

The default Store Locator implementation generates the store list based on the 
city ID. You can modify the implementation to include map service provider 
integration, where the generated store list is based instead on the geocode 
latitude and longitude values. 

Table 4.1 shows a comparison between default implementation in IBM 
WebSphere Commerce and the customization that is required to integrate with a 
third-party map service provide. 
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Table 4- 1 Store Locator implementation comparison 
Default implementation 


Integrating with a map service provider 
implementation 


<wcf:getData 

type= " com . i bm. commerce . store . facade . datatype 
s . Physi cal StoreType [] " 
var="physical Stores" 
varException="physicalStoreException" 

expressi onBui 1 der="f i ndPhysi cal StoresByGeoNo 
deUniqueID"> 

<wcf : param name="accessProf i 1 e" 
value="IBM_Store_Details" /> 

<wcf: param name="uniqueld" value="${cityld}" 
/> 

</wcf :getData> 

Where: 

► The uniqueld parameter generates the store 
list based on the cityld value. 


<wcf :getData 

type= " com. i bm. commerce . store . facade . datatype 
s . Phys i cal StoreType [] " 
var="physi cal Stores" 
varExcepti on="physi cal StoreExcepti on" 

expressi onBui 1 der="fi ndPhysi cal StoresFromGeo 
Code"> 

<wcf: param name="accessProfile" 
value="IBM_Store_Details" /> 

<wcf:param name="lati tude" 
value="${geoCodeLatitude}" /> 

<wcf:param name="longitude" 
val ue="${geoCodeLongi tude}" /> 

</wcf :getData> 

Where: 

► A combination of the latitude and longitude 
parameters generates the store list based on 
the geoCodeLatitude and geoCodeLongitude 
values. 


Important: You should be familiar with your map service provider’s API when 
integrating its enhancements into the Store Locator. 


4.4 MapQuest integration for Store Locator 

In this section, we use MapQuest mapping services for the Store Locator 
functionality. MapQuest mapping service allows you to display a location map in 
a predefined <div> on an HTML page. The map can be centered around a 
specified longitude and latitude, and you can specify a default zoom level. It also 
allows you to add markers to display location of stores. 


Important: To use MapQuest API, you must register with MapQuest and 
obtain a client ID, password, and API keycode. Also, you need to download the 
JavaScript API package from the MapQuest Developer Network at: 

http://developer.mapquest.com 
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By default in the Madisons starter store, the Store Locator functionality displays 
only the address of the stores for a particular Country, State, and City 
combination, as shown in Figure 4-18. 
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Now, you can add a page section that displays the stores location in a MapQuest 
map as follows: 

1 . Extract the JavaScript files from the downloaded 

\cl i ents\javascri pt\compactJS compressed file. Place the extracted files in 
the Stores /WebContent /Madisons /javascript/MapQuest directory. 

2. Include MapQuest JavaScript scripts in 

Stores lUebContentl Madisons/ Sni ppets/StoreLocator . jsp. Example 4-1 
shows a snippet from StoreLocator.jsp. 

Example 4- 1 Include MapQuest JavaScript scripts 
<script 

src= "http://btilelog.access.mapquest.com/tilelog/transaction7transac 
tion=script&key=<fmt:message key="MAP_API_KEY" bundl e="${storeText} " 
/>&itk=true&v=5.3.s&ipkg=control sl"></script> 

<!-- The JSAPI Source files --> 

<script src='<c:out 

val ue="${jsAssetsDir} "/>javascri pt/MapQuest/mqcommon. js 1 type= 1 text/j 
avascri pt 1 ></scri pt> 

<script src='<c:out 

val ue="${ jsAssetsDi r} "/>javascri pt/MapQuest/mquti 1 s . js ' type= 1 text/ja 
vascript'></script> 

<script src='<c:out 

val ue="${ jsAssetsDi r} "/>javascri pt/MapQuest/mqobjects . js ' type= 1 text/ 
javascri pt 'x/scri pt> 

<script src='<c:out 

val ue="${ jsAssetsDi r} "/>javascri pt/MapQuest/mqexec. js ' 
type= 1 text/j avascri pt ' x/scri pt> 


3. Add a <div> to display the map as shown in Example 4-2. 

Example 4-2 Adding a <div> area for displaying map 

<div class="number_info" id="hideMap" style="display:block;"xa 
href =" Javascri pt : storeLocatorJS . hi deMap() ; " cl ass="bl ue"x S pan 
class="font2"xfmt:message key="HIDE_MAP" bundl e="${storeText} " 
/x/ S panx/ a x/div> 

<div class="number_info" id="showMap" style="di splay: none; "xa 
href =" Javascri pt : storeLocatorJS . showMapO ; " cl ass="bl ue"x S pan 
class="font2"xfmt:message key="SHOW_MAP" bundl e="${storeText} " 
/x/ S panx/ a x/div> 

<br clear="all "/xbr /> 
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4. Create a new JavaServer Pages (JSP) StoreLocatorMapResul ts . jsp to return 
the geographical location of the stores in a JSON object as shown in 
Example 4-3. 

Example 4-3 JSP rendering JSON objects containing geographical location data 

//* 

//* Licensed Materials - Property of IBM 
//* 

//* WebSphere Commerce 
//* 

//* (c) Copyright IBM Corp. 2008 
//* 

//* US Government Users Restricted Rights - Use, duplication or 
//* disclosure restricted by GSA ADP Schedule Contract with IBM 
Corp. 

//* 

//* 

//* 


* This JSP constructs the store locator map results. 


<%@ taglib uri="http://java. sun.com/jsp/jstl/fmt" prefix="fmt" %> 
<%@ taglib uri="http://java. sun.com/jsp/jstl/core" prefix="c" %> 

<%@ taglib uri="http://commerce. ibm.com/base" prefix="wcbase" %> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/functions" prefix="fn" 

<%@ taglib uri="flow.tld" prefix="flow" %> 

<%@ taglib uri="http://commerce. ibm.com/foundation" prefix="wcf" %> 
<%@ include file=" . ./. ./include/JSTLEnvironmentSetup. jspf" %> 

<c:set var="cityld" value="-999" /> 

<c:if test="${ iempty WCParam.cityld} "> 

<c:set var="cityld" val ue="${WCParam.cityId} " /> 

</c : i f > 

<c:if test="${ Iempty param.cityld} "> 

<c:set var="cityld" val ue="${param.cityld} " /> 

</c : i f > 
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<c:set var="geoCodeLatitude" value="-999" /> 

<c:if test="${ Iempty WCParam.geoCodeLati tude} "> 

<c:set var="geoCodeLati tude" val ue="${WCParam.geoCodeLatitude} " /> 
</c:if> 

<c:if test="${ iempty param.geoCodeLatitude} "> 

<c:set var="geoCodeLati tude" value="${param.geoCodeLatitude}" /> 
</c:if> 

<c:set var="geoCodeLongitude" value="-999" /> 

<c:if test="${ iempty WCParam.geoCodeLongitude} "> 

<c:set var="geoCodeLongitude" val ue="${WCParam.geoCodeLongi tude} " 

/> 

</c:if> 

<c:if test="${ iempty param.geoCodeLongitude} "> 

<c:set var="geoCodeLongitude" val ue="${param.geoCodeLongitude} " /> 
</c:if> 

<c:choose> 

<c:when test="${cityld != 1 -888 ' } "> 

<wcf :getData 

type="com.ibm.commerce.store.facade.datatypes.PhysicalStoreType[] " 
var=" physical Stores" 
varException="physicalStoreException" 
expressionBui lder="findPhysicalStoresByGeoNodeUniqueID"> 

<wcf:param name="accessProfi le" value="IBM_Store_Details" /> 
<wcf:param name="uniqueld" val ue="${cityld} " /> 

</wcf :getData> 

</c:when> 

<c:otherwise> 

<wcf :getData 

type="com.ibm.commerce.store.facade.datatypes.PhysicalStoreType[] " 
var=" physical Stores" 
varException="physicalStoreException" 
expressi onBui 1 der="f i ndPhysi cal StoresFromGeoCode"> 

<wcf:param name="accessProfi le" value="IBM_Store_Details" /> 
<wcf:param name=" latitude" val ue="${geoCodeLati tude}" /> 
<wcf:param name="longitude" val ue="${geoCodeLongitude} " /> 

</wcf :getData> 

</c:otherwise> 

</c:choose> 


{ 

<c:if test="${empty physicalStoreException}"> 

<c:set var="resul tNum" value="${fn:length(physicalStores)}" /> 
<c:if test="${resul tNum == 0 && cityld == ' -888 ' } "> 
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'centerLati tude 1 :<c:out val ue="${geoCodeLatitude} " />, 
'centerLongi tude 1 :<c:out val ue="${geoCodeLongitude} " />, 
'resultSize' :<c:out val ue="${resul tNum} " /> 

</c:if> 

<c:if test="${resul tNum > 0}"> 

<c:choose> 

<c:when test="${cityld != 1 -888 1 } "> 

'centerLati tude 1 :<c:out 

val ue="${ physical Stores [0] .location Info. geoCode. latitude}" />, 

1 centerLongi tude' :<c:out 

val ue="${ physical Stores [0] .location Info. geoCode. longitude}" />, 
</c:when> 

<c:otherwise> 

'centerLati tude' :<c:out val ue="${geoCodeLati tude} " />, 

' centerLongi tude' :<c:out val ue="${geoCodeLongitude} " />, 
</c:otherwise> 

</c:choose> 

'resultSize' :<c:out val ue="${resul tNum} " />, 

'physical Store' : [ 

<c:forEach var="i" begin="0" end="${resul tNum-1} "> 

{ 'latitude' :<c:out 

val ue="$ {physical Stores [i] .location Info. geoCode. latitude}" />, 
'longitude' :<c:out 

val ue="$ {physical Stores [i] .location Info. geoCode. longitude}" />, 

' html Num' : '<c:out val ue="$ { i +1} " />. 

' html Identifier 1 : '<c:out 

val ue="$ {physical Stores [i] .physi cal Storeldentifier. external Identifie 
r}" />' , 

' html Addressl ' : '<c:out 

val ue="${ physi cal Stores [i] . locat ion Info. address. address Li ne [0] }" 

/>', 

' html Address2' : '<c:out 

value="${physicalStores[i] .locationlnfo. address. city}" />, <c:out 
val ue="${ physi cal Stores [i] . 1 ocat ion Info. address. stateOrProvinceName} 
" /> <c:out 

val ue="${ physi cal Stores [i] .locat ion Info. address. postal Code}" />' } 
<c:if test="${i < resultNum -1}"> 

</c : i f > 

</c:forEach> 

] 

</c : i f > 

</c:if> 

} 
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5. Create a view entry AjaxStoreLocatorMapResultsView in the struts 

configuration file for the new JSP. Update struts-config-ext.xml to contain 
the settings shown in Example 4-4. Use the appropriate storeld. 

Example 4-4 The struts-config-ext.xml entry 

<!-- Global Forwards --> 

<global-forwards> 

<forward cl assName="com. i bm. commerce. struts . ECActionForward" 
name="AjaxStoreLocatorMapResultsView/storeYc/" 
path="/Sni ppets/StoreLocator/StoreLocatorMapResul ts . jsp"/> 


</global-forwards> 

<!-- Action Mappings --> 

<acti on-mappi ngs type="com. i bm. commerce. struts . ECActi onMappi ng"> 
<action path="/AjaxStoreLocatorMapResultsView" 
type="com.ibm. commerce. struts. BaseAction"> 

<set-property property="credentialsAccepted" 
value="store/£/:P"/> 

</action> 


</acti on-mappi ngs> 


6. Grant access for all site users to the new view 

AjaxStoreLocatorMapResultsView. Create a policy XML file 
ACPforMapService.xml as shown in Example 4-5, and place it in the <WCDE 
Install Dir>/xml /pol icies/ directory. 

Example 4-5 Sample access control policy file 

<?xml version="1.0" encoding="IS0-8859-l" standal one="no" ?> 

< ! DOCTYPE Policies SYSTEM " . ./dtd/accesscontrol pol i cies .dtd"> 

<Pol icies> 

<Action Name= "AjaxStoreLocatorMapResultsView" 
CommandName="AjaxStoreLocatorMapResultsView"> 

</Action> 

<ActionGroup Name="Madi sonsAl 1 UsersViews" 
OwnerID="RootOrganization"> 

<ActionGroupAction 

Name="AjaxStoreLocatorMapResultsView"/> 
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</ActionGroup: 


</Policies> 


7. Load the policy using the following command: 
acpload ACPforMapService.xml 

8. Check <UCDE Install Dir>/logs/acpload.log for any errors. 


Important: If you are a using derby database, make sure the server is not 
running when you run the acpload command. If you are using other 
database, use the appropriate syntax for the acpload command. 


9. Attach the properties names-values shown in Example 4-6 to the 

Stores\WebContent\WEB-INF\cl asses\Madi sons\storetext . properties file. 
Use the appropriate values for the API Keycode. 

Example 4-6 Properties used in the JSP file 

# StoreLocator. jsp 

ENTER_ZIPPOSTALCODE = Zip/Postal Code: 

OR = Or 

G0_BUTT0N_LABEL = GO 
HIDE_MAP = Hide Map 
SH0W_MAP = View Map 

# StoreLocator. jsp - error messages 

MISSING_ZI PC0DE_FI ELD = This is required field. Please enter the 
val ue. 

# Do not translate begins 


# MAP_API_KEY to be replaced by Map API key (Google or Mapquest) of 
the server 

# StoreLocator. jsp, StoreLocator. js 
MAPAPIKEY = <API Keycode> 

# Do not translate ends 
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10. Add the code shown in Example 4-7 to the following JavaScript file: 

Stores/WebContent/Atoc/isons/javascript/StoreLocatorArea/StoreLocator.js 
Example 4-7 New methods and attributes for StoreLocator object 

/* variables declarations */ 
resultGeocodeLatitude: null, 
resultGeocodeLongitude: null, 
resultCityld: null, 

/** 

* This function stores the parameters that are used to generated 
the result area. 

* @param renderContext The render context. 

*/ 

saveResul ts : f uncti on (renderContext) { 
storeLocatorJS . resul tGeocodeLati tude = 
renderContext . properties ["geoCodeLati tude"] ; 

storeLocatorJS .resul tGeocodeLongi tude = 
renderContext . properties ["geoCodeLongi tude"] ; 

storeLocatorJS. resultCityld = 
renderContext. properties ["city Id"] ; 

}, 


/** 

* This function hides the map and the "hide map" text, and shows 
the "show map" text. 

*/ 

hideMap:function() { 

var hideMapDiv = dojo.byId("hideMap") ; 
var mapImplDiv = dojo.byId("mapImpl ") ; 
var showMapDiv = dojo.byId("showMap") ; 

hideMapDiv. style. display = "none"; 
mapImplDiv. style. display = "none"; 

showMapDiv. style. display = "block"; 

}, 


* This function shows the map and the "hide map" text, and hides 
the "show map" text. 
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*/ 

showMap:function() { 

var hideMapDiv = dojo.byId("hideMap") ; 
var mapImplDiv = dojo.byId("mapImpl ") ; 
var showMapDiv = dojo.byId("showMap") ; 

hideMapDiv. style. display = "block"; 
mapImplDiv. style. display = "block"; 

showMapDiv. style. display = "none"; 

/* display the map */ 

if (storeLocatorJS.resultGeocodeLati tude == null) { 
var serviceResponse = null; 
var ioArgs = null; 

storeLocatorJS . di spl ayMap (servi ceResponse, i oArgs) ; 

} 

else { 

var parameters = {}; 
parameters. geoCodeLatitude = 
storeLocatorJS . resul tGeocodeLati tude; 

parameters. geoCodeLongi tude = 
storeLocatorJS .resul t GeocodeLongi tude; 

parameters. city Id = storeLocatorJS. resultCityld; 

dojo.xhrPost({ 

url : "AjaxStoreLocatorMapResultsView", 
handleAs: "json", 
content: parameters, 
service: this, 

load: storeLocatorJS. displayMap, 
error: f uncti on (errObj, ioArgs) { 
alert("Error occurs!"); 


}); 


* This function synchronizes the display style of the map with 
the "hide Map" text. So that the map is shown 

* or hidden consistently with the "hide map" / "show map" texts. 

*/ 
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syncMapDisplayStyle:function() { 

var hideMapDiv = dojo.byId("hideMap") ; 
var mapImplDiv = dojo.byId("mapImpl ") ; 

if (hideMapDiv. style. display == "none") { 
mapImplDiv. style. display = "none"; 

} 

else { 

mapImplDiv. style. display = "block"; 

} 

b 


* This callback function displays / refreshes the map of the 
result area using the JSON object returned. The 

* map becomes blank when: 

* 1. the page is first loaded, no search has been 
performed 

* 2. search by geo node (i.e. city) is performed and 0 
physical store is found 

* 3. search by zip postal code is performed and 0 physical 
store is found 

* 4. search is performed and nothing is returned by Map 
service provider 

* @param serviceResponse The service response. 

* @param ioArgs The 10 arguments. 

*/ 

displayMap:function(serviceResponse, ioArgs) { 

storeLocatorJS . syncMapDi spl ayStyl e () ; 

/* display the map only when the div is visible to the user at 
the moment */ 

var mapImplDiv = dojo.byId("mapImpl ") ; 

var showMap = true; 

if (mapImplDiv. style. display == "none") { 
showMap = false; 

} 

if (showMap == true) { 

if (serviceResponse != null && 
serviceResponse. centerLatitude != null && 
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serviceResponse.centerLatitude != 'undefined' && 
serviceResponse.centerLatitude !=''){ 

var centerLatitude = serviceResponse.centerLatitude; 
var centerLongitude = serviceResponse.centerLongitude; 
var resultSize = serviceResponse.resultSize; 

/* the map will be shown only when at least one store 
location is found */ 

if (resultSize > 0) { 

var map = new MQA.Ti 1 eMap(mapImpl Di v) ; 
var glatlng = new MQLatLng (centerLatitude, 
centerLongitude) ; 

map.setCenter(gl atl ng, 10); 

for (var i =0 ; i<resultSize; i++) { 
var title = 

servi ceResponse. physi cal Store [i] .html Identifier; 
var info = 

serviceResponse.physicalStore[i] .html Addressl + "<br/>" + 

servi ceResponse . physical Store [i ] . html Address2; 
glatlng = new 

MQLatLng (servi ceResponse . physical Store [i ] . 1 ati tude, 

serviceResponse.physicalStore[i] .longitude) ; 

var poi = new MQA. Poi (gl atl ng) ; 
poi .setValue("infoTitleHTML", title); 
poi .setValue("infoContentHTML", info); 
poi .setValue("key", i); 

map.addShape(poi); 

} 

map.addControl (new MQA. LargeZoomControl (map)); 
map.setSize() ; 


} 

}, 
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11. Modify refreshSearchResults() in the following JavaScript file as shown in 
Example 4-8: 

Stores/WebContent/Atodisons/javascript/StoreLocatorArea/StoreLocator.js 

Example 4-8 Modification to allow for map refresh 

ref reshSearchResul ts : functi on (f romPage) { 
var performFindFlag = 

Physi cal StoreCookieJS.getValueFromCookie("WC_st Find") ; 

var citySelectedlndex = dojo.byId("selectCity") .selectedlndex; 
if (citySelectedlndex > -1) { 

var indexToUse = citySelectedlndex; 
var indexFromSavedld = 
storeLocatorJS.getSavedCitySelectionIndex() ; 

if (indexFromSavedld != null && indexFromSavedld != 
citySelectedlndex) { 

indexToUse = indexFromSavedld; 

dojo.byId("selectCity") .options[indexTollse] .selected = 

true; 

} 


if (performFindFlag != null) { 
if (performFindFlag == 1) { 

wc . render . updateContext ( ' storeLocatorResul tsContext ' , 
{ 'city Id' :dojo.byId("selectCity") .options [indexToUse] .value, 
'geoCodeLatitude' : '-888' , 'geoCodeLongitude' : '-888' , 

1 f romPage ' : fromPage} ) ; 



12. Modify the following JavaScript file to refresh the store location on the map as 
shown in Example 4-9: 

Stores /WebContent /Madisons/ javascri pt/StoreLocatorArea/StoreLocatorC 
ontrol lersDeclaration.js 

Example 4-9 The postRefreshHandler () function to refresh store location on the map 

postRefreshHandler: function(widget) { 
var controller = this; 
var renderContext = this.renderContext; 

/* store the parameters (i.e. the state of the page) so the 
map can be loaded properly */ 
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/* for view map after hide map */ 
storeLocatorJS . saveResul ts (renderContext) ; 

/* refresh the map on the result area */ 
var parameters = {}; 
parameters. geoCodeLatitude = 
renderContext . properties ["geoCodeLatitude"] ; 

parameters. geoCodeLongitude = 
renderContext . properties ["geoCodeLongitude"] ; 

parameters. city Id = renderContext. properties["cityId"] ; 

dojo.xhrPost({ 

url : "AjaxStoreLocatorMapResultsView", 
handleAs: "json", 
content: parameters, 
service: this, 

load: storeLocatorJS. displayMap, 
error: function(errObj,ioArgs) { 
alert("error") ; 


}); 

var bopisTable = dojo.byId("bopis_table") ; 
if (bopisTable != null && bopisTable != "undefined") { 
bopisTable. focus() ; 

} 

var noStoreMsg = dojo.byId("no_store_message") ; 
if (noStoreMsg != null && noStoreMsg != "undefined") { 
noStoreMsg. focus() ; 

} 


cursor_clear() ; 

} 


13. Start the server. 

14. Open the Madisons starter store home page in a browser, and go to the Store 
Locator page using the link at the right-hand, top corner of the page 
(Figure 4-19). 



Figure 4-19 Store Locator link 
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15. In the Store Locator page, click Go to the right of the City drop-down menu to 
display all the stores in that city (Figure 4-20). 


Country: State/Province: 

Canada LyJ Alberta 


□33 [.CaLgary 


□ 3 ! 



Store Locator Results 


Calgary Circle Mall 
300 MacLeod Tr 
Calgary, Alberta T2G 5R1 
511.S13.5789 

1025 Cameron Ave SW 
Calgary, Alberta T2T 0K4 
367.666.6666 


SELECT STORE 


Mon-Fri: 10am - 9pm 
Sat: Sam - 7pm 
Sun: 11am - 6pm 


Figure 4-20 Result of store search in a city 
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4.5 MapQuest Geocoding 


MapQuest Geocoding allows a user to obtain the geographical co-ordinates 
(longitude and latitude) for a given address. The input address can contain all 
details (such as the street, city, zip code, and country information) or just the zip 
code and country information. 

In this section, we explain how to use this feature to obtain all the nearby stores 
for a zip code. 


4.5.1 Install MapQuest JavaScript API proxy 

Because of cross-site scripting limitations, MapQuest provides a JavaScript API 
which communicates with a proxy in the same domain as the requested page. 
The proxy in turn forwards the request to the MapQuest server. The result is then 
returned to the JavaScript API at the client. 

In this section, we set up the JavaScript API proxy on the IBM WebSphere 
Commerce server as follows: 

1 . Extract the JSAPIProxyPage from the downloaded clients compressed file 
\cl ients\javascript\proxy\java\JSAPIProxyPage. The JSAPIProxyPage 
directory contains the files listed in Example 4-10. 

Example 4-10 Content of the JSAPIProxyPage directory 

com (directory) 

README.txt 
TestXML.html 
Utils. js 
web. xml 
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2. Open WebSphere Commerce Toolkit and create a new Dynamic Web project 
(Figure 4-21). Enter a Project name. Make sure that the “Add project to an 
EAR” box is selected. Click Next. 



Figure 4-21 New Dynamic Web Project wizard 
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3. Enter a Context Root, and clear the “Generate deployment descriptor” option 
as shown in Figure 4-22. In this scenario, we use the deployment descriptor 
that MapQuest provides. Click Finish. 



Figure 4-22 Step 2 of create Dynamic Web Project wizard 
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In the Java perspective, you see that a new project is created, as shown in 
Figure 4-23. 



4. Copy the com folder from JSAPIProxyPage to the src folder. 


Important: Make sure that Project 0 Build Automatically is turned on. 
Otherwise, you will have to rebuild the project to make sure that the Java 
code is compiled. 


5. Copy the web. xml file from JSAPIProxyPage to WEB-INF. 

6. CopytheTestXML.html and util s.js files from JSAPIProxyPage to the 
WebContent folder. 

7. Open the web. xml file. Change the values shown in Example 4-1 1 to the 
appropriate values, and save the file. 

Example 4- 1 1 Replace with your MapQuest Client ID and Password 

<param-val u e>Your_Cl ienf /c/</param-val ue> 

<param-val ue>Xour_Passworc/</param-val ue> 
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8. Start the server. 

9. Open the following URL in a browser: 
http://ZocaZ/?osZ'/jsapi/TestXML.htrnl 

The MapWare XML Test Page should display. 

10. Make sure sname is the appropriate server name in the MapQuest request 
URL: 

JSReqHandl er?sname=geocode. dev.mapquest . com&spath=mq&sport=80 

11. Click Send Data. 

The results of the default geocoding request should display at the bottom of the 
page as shown in Figure 4-24. 


Server to send request to: 

|jSReqHandler?sname=geocode.dev.mapquestcom&spath=mq&sport=80| 


data to send: 


< Geocod e Version= n l"> 

<Address> 

<AdrainAreal>US</AdminAreal> 
< PostalCode > S 0203</PoscalCode> 
</Address> 

<Narae>^gauro</Narae> 

<MaxMa t ches > 6< / MaxMa t ches > 

< / Auc oGe o co de Co vSwi t ch > 
Authentication Version="2"> 
<TransactianIn^ 
</Authentication> 

</Geocode> 


| [Send Data! ] 
response: 

<?xnl version="1.0" encoding="ISO-8859-l"?> 

< :-e: ir.eexl; Idlle ; e : ^ 2 r e = = > < in r. A r e a 1 > V 3 < . A dm A r e a 1 > < A 

County</AdminArea4><AdiniiiArea5>Denver</AdiainArea5><Po3talCode>80203</Po3CalCode><LatLnS[> 
<ResultCode > “ 1 ?s»-j.lo::de><3;ur ;e:d>r.a— ;< fnrieldx 3e:Adii“s>< za. 1 l :r. Z : Lie 2 ~.l:' 


Figure 4-24 A successful geocode response from MapQuest 
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Important: Make sure that this function is working before you continue to the 
next section. 


4.5.2 Integration with IBM WebSphere Commerce 

In the previous section, we explained how to configure the JavaScript API proxy, 
which communicates with MapQuest servers for Geocoding services. In this 
section, we describe how to use the MapQuest Geocoding API to make a 
geocoding request based on zip code and display the same on the map: 

1 . Modify the JSP for zip code entry. 

a. Include an input box enabling a user to enter a zip code as shown in 
Example 4-12. 

Example 4-12 Include an input box enabling user to enter a zip code 

<input name="textZipPostalCode" id="textZipPostalCode" type="text" 
class="input" height="19" size="14" onKeyPress="Javascript:if 
(event. keyCode == 13) { 

storeLocatorJS.preRefreshResul tsFromZip(document.${formName}) ; 
return false; } else return;" /> 


b. Include the <scri pt> tag as shown in Example 4-1 3 to display an alert in 
case the user does not enter a zip code before clicking OK for a zip code 
search. 

Example 4-13 Message for missing zip code 
<script> 

MessageHel per.setMessage("MISSING_ZIPCODE_FIELD" , "<fmt message 
key = ' M I SS I NG_Z I PC0DE_FI ELD 1 bundle='${storeText} ' />"); 

</script> 


2. Add the code shown in Example 4-14 to the following JavaScript file: 

Stores/WebContent/Wac/isons/javascript/StoreLocatorArea/StoreLocator.js 
The proxyServerName and proxyServerPort strings are empty strings 
because the same server is acting as the proxy for MapQuest request as the 
server for the store pages. Use appropriate values if that is not the case in 
your environment. 

Also use appropriate values for ProxyServerPath, serverName, and 
serverPort. 
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Important: While performing a zip code search, we use a default value of 
Canada for the country. Make sure that you use an appropriate country on 
which your site user can perform a zip code search. 


Example 4-14 New methods for StoreLocator object 

* This function manages the cookie values when OK button is 
pressed from zip search. 

* @param {String} cookieValue The value to be set at the cookie 

key. 

*/ 

manageCookieFromZip:function(cookieVal ue) { 

Physical StoreCooki eJS . setVal ueToCooki e ("WC_stZi p" , 
cookieVal ue) ; 

Phys i cal StoreCooki eJS. setVal ueToCooki e( 1 WC_stFi nd 1 , 2) ; 

}, 


* This function creates a request to Map service provider 
requesting the geocode of a zip/postal code when non-empty 
zip/postal 

* code is entered by the user. 

* @param form The form that contains the text field "zip/postal 
code" entered by the user. 

*/ 

preRef reshResul tsFromZi p : f uncti on (form) { 
reWhiteSpace = new RegExp (/'As+S/) ; 

if (form.textZipPostalCode != null && 
reWhiteSpace. test(form.textZipPostalCode. value) | | 
form.textZipPostalCode. value == "") { 

MessageHel per . formErrorHandl eCl i ent (form. textZi pPostal Code .id, 
MessageHel per.messages["MISSING_ZIPCODE_FIELD"] ) ; 
return; 

} 

/* manage cookie values */ 
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storeLocatorJS.manageCookieFromZip(form.textZipPostalCode.val ue) ; 

var proxyServerName = 
var proxyServerPort = 

var ProxyServerPath = "/jsapi/JSReqHandler"; 
var serverName = "geocode.dev.mapquest.com"; 
var serverPort = "80"; 
var serverPath = "mq"; 

var geoExec = new MQExec (serverName, serverPath, 

serverPort, proxyServerName, ProxyServerPath, 
proxyServerPort ); 

var address = new MQAddressQ; 

address . setPostal Code (form. textZi pPostal Code . val ue) ; 

address. setCountry ("Canada") ; 

var gaCol lection = new MQLocationCol lection("MQGeoAddress") ; 
geoExec. geocode(address, gaCol lection) ; 
var geoAddr = gaCol 1 ection. get (0) ; 

var geoCodeLongitude = geoAddr. getMQLatLng() .getLongitude() ; 
var geoCodeLati tude = geoAddr. getMQLatLng() .getLatitudeQ ; 

/* refresh the result area */ 

wc . render . updateContext ( ' storeLocatorResul tsContext 1 , 

{ 'geoCodeLati tude 1 :geoCodeLatitude, 

'geoCodeLongitude' :geoCodeLongitude, 1 ci ty Id ' : '-888' , 

' fromPage' :StoreLocatorContextsJS.fromPage}) ; 

}, 


3. Modify refreshSearchResults() in the 

Stores /UebContent /Madisons /javascri pt/StoreLocatorArea/StoreLocator. 
js file. 

Example 4-15 Modification to allow for map refresh using zip code 

ref reshSearchResul ts : functi on (fromPage) { 
var performFindFlag = 

Physi cal StoreCookieJS.getValueFromCookie("WC_st Find") ; 

var citySelectedlndex = dojo.byId("selectCity") .selectedlndex; 
if (citySelectedlndex > -1) { 

var indexToUse = citySelectedlndex; 
var indexFromSavedld = 
storeLocatorJS.getSavedCitySel ection Index () ; 


Chapter 4. Web 2.0 storefront 1 73 



if (indexFromSavedld != null && i ndexFromSavedld != 
citySelectedlndex) { 

indexTollse = indexFromSavedld; 

dojo.byId("selectCity") .options[indexTollse] .selected = 

true; 

} 


if (performFindFlag != null) { 
if (performFindFlag == 1) { 

wc . render . updateContext ( ' storeLocatorResul tsContext 1 , 
{' city Id 1 :dojo.byId("selectCity") .options [indexTollse] .val ue, 
'geoCodeLatitude' : 1 -888' , 'geoCodeLongitude' : 1 -888' , 

'fromPage' :fromPage}) ; 


} 

var savedZip = 

Physical StoreCooki eJS . getVal ueFromCooki e ("WCstZi p") ; 

if (savedZip != null) { 

dojo.byId("searchByGeoNodeForm") .textZipPostal Code. val ue = 

savedZip; 


if (performFindFlag != null) { 
if (performFindFlag == 2) { 

storeLocatorJS.preRefreshResul tsFromZip(dojo.byId("searchByGeoNodeFo 
rm")); 


} 

}, 


4. Start the server. 

5. Open the Madisons starter store home page in a browser, and go to the Store 
Locator page using the link at the right-hand, top corner of the page 
(Figure 4-25). 



Figure 4-25 Store Locator link 
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6. Enter a valid Canadian zip code (we used T2T 0L7) in the Zip/Postal Code 
field, and click Go. The page displays a map section with store location 
pointed in the same (Figure 4-26). 



Figure 4-26 Result of a zip code search 
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5 


Mobile commerce features in 
WebSphere Commerce V7 

This chapter expands on the description of the mobile features in IBM 
WebSphere Commerce V7 introduced in Chapter 2, “IBM WebSphere 
Commerce V7 features” on page 29. It includes a more in-depth description 
about how you can use these mobile features and discusses specifically how to 
define e-Marketing Spots and promotions for mobile users. 

We also describe customization scenarios that showing how to use Google Maps 
with the Store Locator functionality on a mobile device, how to enable product 
ratings and reviews for the mobile device, and how to amend the existing 
checkout flow in Madisons Mobile Starter Store with the ability for mobile users to 
have products shipped, rather than picking up the merchandise at a 
brick-and-mortar store. 

This chapter includes the following topics: 

► Madisons Mobile Starter Store 

► Integration with a map service provider for the mobile Store Locator 

► Buy on mobile device and select shipping address 

► Product ratings and review 

► Analytics 


© Copyright IBM Corp. 2010. All rights reserved. 
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5.1 Madisons Mobile Starter Store 


Today, mobile commerce is about the explosion of applications and services that 
have become accessible from Internet-enabled mobile devices. The devices we 
use are more personal, and a cross-channel solution is more relevant for most 
industries. WebSphere Commerce provides the best infrastructure to achieve an 
effective cross-channel solution in today’s ever-changing mobile commerce 
environment. 

5.1 .1 Mobile commerce overview in WebSphere Commerce 

Using WebSphere Commerce in mobile commerce provides the following 
benefits: 

► Web and in-store integration 

► Single view of customers and their orders 

► Store Information and Locator 

► Inventory visibility across channels 

► Broaden customer base to mobile (in store) users 

WebSphere Commerce delivers the following key features for cross-channel 
Mobile Commerce: 

► The Madisons Mobile Starter Store template with optimized shopping flow for 
smartphone users that provides a common framework to reduce operating 
cost. Madisons mobile starter store delivers a generic mobile user interface 
(Ul) that you can use to define the following templates: 

- Product Information and Availability 

- Order status and Tracking 

- Store and Stock Locator 

- Mobile Wish List or Shopping List 

- Mobile Marketing 

► WebSphere Commerce provides Mobile Message Support, which is the 
WebSphere Commerce version of Short Message Service (SMS) support, for 
order status, promotions, and other marketing messages such as store 
events and sales. 

► WebSphere Commerce integrates into Precision Marketing with support for 
mobile triggers and actions using product content and e-Marketing Spots that 
are targeted to mobile shoppers. 
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WebSphere Commerce also has the following Mobile Device Optimizations: 

► Standards Compliant 

- Adheres to W3 Mobile Best Practices 

- Passes mobile OK Scheme 1 .0 “Basic Tests” 

► Compactness 

- Desktop accessible store pages have been reorganized 

- Some page functions omitted 

- Some images omitted 

► Mobile Shopper Targeting 

- Shopper elects to receive messages to mobile device by registering phone 
number. 

► Design 

- Easy to customize and deploy templates 

- Support mobile phones with 240*320 or higher resolution 

- Tested with Blackberry, iPhone, Nokia, Windows® Mobile, and Android 

- Partner’s transcoding services with mobile business rules 

- A common commerce engine with the following mobile business rules: 

• Device or browser detection and routing 

• Mobile specific product content and marketing/promotion 

• Channel aware mobile transactions for analytics 


5.1.2 Madisons Mobile Starter Store 

The Madisons Mobile Starter Store enables customers to browse the storefront 
using their mobile devices. Table 5-1 provides the URLs for the Madisons Mobile 
Starter Store and the Madisons mobile starter store. 


Table 5-1 The URLs for the Madisons Starter Store and the Madisons Mobile Starter Store 


Store 

URL 

Madisons Starter Store Web 

http://localhost/webapp/wcs/stores/Madisons/index.jsp 

Madisons Mobile Starter Store 

http : //local host/webapp/wcs/stores/Madi sons/mobi 1 e/ i ndex. j sp 


The Madisons Mobile Starter Store can act as a base for implementing mobile 
storefronts. Deploying the Madisons Mobile Starter Store and integrating SMS 
support ensures that your WebSphere Commerce implementation captures the 
current Web and mobile technologies. 
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Figure 5-1 shows the Madisons Starter Store and the Madisons Mobile Starter 
Store Web interface. 



Figure 5-1 The Madisons Starter Store and the Madisons Mobile Starter Store Web interface 
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Main features 

The Madisons Mobile Starter Store includes the following mobile optimized store 
pages: 

► User Registration 

► Mobile Marketing / Promotion 

► Product Information / Availability 

► Store / Stock Locator 

► Mobile Shopping List (Wish List) 

► Buy online, pickup in store 

► Order Status and Tracking 

Site flow and interactions 

The Madisons Mobile Starter Store provides a comprehensive layout of 
components that you must identify in order to develop a mobile strategy with 
business staff. In this section, we analyze the Site Flow for each store page as 
well as the how each store page interacts with other pages. 

There are four main subsystems on the Site Flow: 

► Member Subsystem 

Provides the pages to register a new customer and to log on with credentials. 
It also provides a full overview of the main assets, such as Orders, Wish List, 
and Suscriptions. 

► Catalog Subsystem 

Provides the pages for Category, Product and Searching Tasks. 

► Order Subsystem: 

Provides the pages for Order Information, Order Summary and Shopping 
Cart. 

► Main Subsytem (Home Page): 

Provides access to Preferences, Contact Us, Privacy Policy, Store Locator, 
Wish List, and Order Status. 

Madisons Mobile Starter Store components 

Each mobile Web page includes the following elements: 

► JavaServer Pages (JSP) files, which include a JSP file for the entire page, 
header, footer, and recommended e-Marketing Spot JSP if applicable. 

► JSP fragments, which according to checkout flow include JSP components for 
the product or SKU search function, department browser listing, and store 
options display (such as Store Locator). 
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► E-Marketing and Content spots, which are specialized JSPs that provide 
marketing information. The Madisons Mobile Starter Store e-Marketing Spots 
contain the prefix Mobile to distinguish them from Madisons Mobile Starter 
Store e-Marketing Spots of the same name. The mobile e-Marketing Spots 
include: 

- MobileApparelFeaturedProducts 

- MobileFurnitureFeaturedProducts 

- MobileHomePage 

- MobileHomePageFeaturedProducts 

- MobileKitchenwareFeaturedProducts 

- MobileTablewareFeaturedProducts 

► Links and buttons, which are the reference points that navigate you to a whole 
document or to a specific element within a document. Links and buttons 
provide each mobile Web page with a more efficient user interaction model. 

The next section provides an example mobile home page and discusses the 
components of this page. 
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Example mobile store pages 

Figure 5-2 show a sample of mobile store pages. 



Figure 5-2 Madisons Mobile Starter Store home page 


The mobile home page helps customers navigate the store by displaying a 
search entry, followed by a list of available departments to browse, each of which 
contains products. The recommended category and featured products 
e-Marketing Spots contain highly visible product image placements, as they are 
directly featured on the home page of the store. Additional features of the home 
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page include the ability to locate a store by providing a link to the Store Locator 
page. 

The main components of the mobile home page include JSP files, JSP file 
fragments, e-Marketing and Content spots, and links and buttons: 

► JSP files 

- The Mobil eHome.jsp file represents the entire page. 

- The CachedHeaderDisplay.jsp file displays the store’s header. 

- The CachedFooterDisplay.jsp file displays the store’s footer. 

- The ContentAreaESpot.jsp file displays the recommended category 
e-Marketing Spot. 

- The FeaturedProductsESpot. jsp file displays the featured products 
e-Marketing Spot. 

► JSP file fragments 

- The searchHeader. jspf file displays the product/SKU search function. 

- The BrowseDepartments . jspf file displays the department browsing listing. 

- The storeOptions.jspf file displays the store options (for example, the 
Store Locator). 

► E-Marketing and Content spots: 

- The recommended category e-Marketing Spot displays. 

- The featured products e-Marketing Spot displays. 

► Links and buttons 

- When the user clicks Go, the CatalogSearchResultsDisplayView is called. 

- When the user clicks More info, the recommended category from the 
e-Marketing Spot is called. 

- When the user clicks a department, the CategoriesDisplay is called. 

- When the user clicks Locate a Store, the StoreLocator is called. 

- When the user clicks a product, the ProductDisplay is called. 

You can find more information about Madisons Mobile Starter Store components 
in the WebSphere Commerce Version 7 Information Center at: 
http : / /publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index.jsp?topic=/ 
com. ibm. commerce. madisons-starterstore.doc/concepts/csmmadi sonintro.htm 
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Because Madisons Mobile Starter Store provides mobile Web page components, 
you can study the following main mobile flows to analyze how your company can 
integrate a marketing strategy: 

► Mobile catalog browsing flow 

► Mobile Store Locator flow 

► Mobile checkout flow 

Mobile catalog browsing flow 

The catalog browsing flows in the Madisons Mobile Starter Store include the 
overall mobile layout, home, department, category, product details, product 
compare, advanced search, and search results pages. The following key points 
of this flow identify customer interaction: 

► Product Navigation and Search: Customers can navigate by categories, 
products, and items. They also can search by SKU, attributes, price, range, 
and so forth. 

► Demand Generation: Using these Web pages, you can add e-Marketing 
Spots. You can also use the Wish List as a main tool for marketing. 

► Product comparison: Customers can make side-by-side comparison by 
attributes and can list inventory availability by stores and online. 

Table 5-2 describes the mobile catalog browsing flow. 


Table 5-2 Mobile catalog browsing flow 


Pages 

Description 

Mobile overall layout 

The overall layout remains consistent throughout the Madisons 
Mobile Starter Store and contains three main sections: 

► The header 

► Breadcrumb trail 

► Footer 

Mobile home 

The mobile home page helps customers navigate the store by 
displaying a search entry, followed by a list of available departments 
to browse, each of which contains products. The recommended 
category and featured products e-Marketing Spots contain highly 
visible product image placements, as they are directly featured on the 
home page of the store. Additional features of the home page include 
the ability to locate a store by providing a link to the Store Locator 
page. 

Mobile category 

The mobile category pages help customers navigate through the 
store by only displaying products based on the category that is 
viewed. The level of precision is increased by viewing products and 
subcategories based on the category to which they belong. Products 
display with a picture, name, price, and stock availability. 
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Pages 

Description 

Mobile product details 

The mobile product details page is the main page where the customer 
can view single products. Products display with a name, picture, price, 
stock availability, and description. The product picture is larger on the 
product details page than it is on other store pages, enabling the 
customer to observe the product in more detail. The customer can 
add the product to the shopping cart or wish list, select a product to 
compare, check the product availability, and select the previous and 
next product in the category. 

Mobile product compare 

The mobile product compare page enables the customer to compare 
up to four products at the same time. The products display vertically 
with pictures, descriptions, stock availability, and product-specific 
attributes in an organized table. The product compare enables 
customers to compare products easily without navigating to each 
product page and comparing the features of each product manually. 
A customer can remove a product directly from the compare list 
without leaving the product compare page. 

Mobile advanced search 

The mobile advanced search page enables customers to produce 
precise search results using several attributes. The search filters 
include the search term and methods for searching within the term, 
locations to search within, brands, price range, category, and number 
of results per page. 

Mobile search results 

The mobile search results page displays after the customer submits 
a search. 
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Figure 5-3 illustrates sample mobile store pages for the mobile catalog browsing 
flow. 


[^ MADISONS MOBILE Sign In 
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Figure 5-3 Mobile catalog browsing flow pages 
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Mobile Store Locator flow 

The Store Locator flows in the Madisons Mobile Starter Store include the Store 
Locator, Store Locator results, store details, and map service provider integration 
scenarios. The following key points of this flow identify customer interaction: 

► Store location search by city or zip code: Directions from a shopper’s GPS 
location to the selected store. 

► GPS-based store search: Show the nearest stores based on the shopper’s 
GPS location. 

► Store Information: Store hours, address, and other information or click to call 
the store associate. 

Table 5-3 describes the mobile store locator flow. 


Table 5-3 Mobile store locator flow 


Pages 

Description 

Mobile Store Locator 

Customers can use the mobile Store Locator feature to 
locate a nearby store. A list of stores is given based on the 
inputted location. The customer can customize the resulting 
store list to display a set number of stores. Customers can 
select multiple store locations. When checking the 
availability of a product, however, the Store Locator must be 
used before the availability of a product can be verified. 

Mobile Store Locator results 

The mobile Store Locator results displays the store’s name, 
address, hours, and phone number, as well as the option to 
map the location and the option to add the store to the store 
list. If a partial search is made for a city name and multiple 
cities are found, a list displays to select the city. 

Mobile Store Locator store details 

The mobile store details page displays the store’s name, 
address, and phone number, as well as the option to map 
the location and the store's hours. 

Integrating with map service providers 

The customer can customize the mobile Store Locator to 
integrate with map service providers, providing enhanced 
searching and displaying capabilities on the Store Locator 
page. 
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Figure 5-4 illustrates a sample mobile store page for the store locator browsing 
flow. 



Figure 5-4 Store Locator mobile page 


Mobile checkout standard flow 

The checkout flows in the Madisons Mobile Starter Store include the Shopping 
Cart, sign in, Store Locator, Store Locator results, store list, billing address 
selection or entry, payment method, order summary, and order confirmation 
pages. The following key points of this flow identify customer interaction: 

► Customer has access to the following product details: 

- Product image, description, and price 

- Inventory availability across channels 

- List of favorite stores by user preference 

► Buy on line and pickup in store 

- Quick checkout flow 

- Payment plug-in architecture to enable mobile specific payment methods 
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Table 5-4 describes the Madisons Mobile Starter Store checkout standard flow. 


Table 5-4 Madisons Mobile Starter Store checkout standard flow 


Pages 

Description 

Mobile shopping cart 

The shopping cart displays the items that are added to the 
Shopping Cart. 

Mobile checkout sign in 

Registered customers can use the mobile checkout sign in 
page to log on to the store before checkout. Signing in 
enables the customer to use the quick checkout, because 
much of their personal information is already registered with 
the store. 

Mobile checkout Store Locator 

The Store Locator is used during the mobile checkout to 
locate a convenient store location to pick up the order. 
Customers can search by zip code or city name. 

Mobile checkout Store Locator results 

A list of store locations displays during the mobile checkout, 
with each store’s name, address, hours of operation, phone 
number, and map link. Customers can add stores to the store 
list. Customers must add a store to the store list to continue 
checkout, where they must select a store location as the 
pickup location. 

Mobile checkout store list 

The customer can select a store location from the store list to 
pickup the order. Each store location in the store list contains 
the store’s name, address, hours of operation, phone 
number, and stock status. Customers can remove a store 
location from the store list. After selecting a store, the 
customer can continue checkout and complete billing and 
payment information. 

Mobile checkout select billing address 

The customer can select billing address information to 
continue with the mobile checkout. If a different billing 
address is required, clicking Create new address enables 
the customer to enter a new address during checkout. 

Mobile checkout enter billing address 

The customer can enter billing address information to 
continue with the mobile checkout. The billing fields include 
the recipient, first name, last name, street address, city, 
country or region, state or province, zip code, phone number, 
and e-mail address. 

Mobile checkout payment method 

Customers can use the mobile checkout payment page to 
enter payment method and information and, optionally, to 
enter a promotion code to receive further order discounts. 
The customer must click Update Order Total to apply the 
promotion code to the order. 
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Pages 

Description 

Mobile checkout order summary 

The mobile checkout order summary displays the details 
submitted during the mobile checkout. The information 
includes the store pickup location, billing address and 
method, and items in the order. The order’s subtotal, any 
discounts, tax, shipping, and total are tallied and displayed 
following the order information. The customer must click 
Place your order to complete the mobile checkout. 

Mobile checkout order confirmation 

The mobile checkout order confirmation displays the final 
details for the mobile checkout. The information includes the 
order number and date, store pickup location, billing address 
and method, and items in the order. The order’s subtotal, any 
discounts, tax, shipping, and total are tallied and displayed 
following the order information. To return to the home page, 
the customer can click Continue shopping. 


For more details about the standard checkout flow, refer to 5.4.1 , “Standard 
checkout page flow for Madisons Mobile Starter Store” on page 221 . 

5.1.3 Mobile marketing 

With previous versions of the Madisons mobile starter store, it was possible to 
add data from a marketing activity, such as a campaign. With this version of the 
Madisons mobile starter store, the concept of mobile marketing opens up a new 
communications channel. You can now create marketing activities that send text 
messages (that is, an SMS) to customers. For example, you can send a text 
message to customers to provide them with a promotion code to use when they 
visit your Web site or to inform them about an upcoming sale. This new feature 
makes it easy to integrate mobile technologies into your marketing strategy. In 
addition, this version of the Madisons mobile store introduces the concept of 
e-Marketing Spots. 

Mobile marketing offers a direct, personal and time-sensitive means to get 
marketing messages out to your customers. You can create Dialog activities that 
capitalize on these advantages. The Dialog activity uses the Send Message 
action to send a text message (that is, an SMS). You can either send a text SMS 
message to a customer in response to a specific action (such as the customer 
registering with the store) or send the text message in bulk to one or more 
customer segments on a specific day. Either way, you can reach customers 
wherever they are and draw them back to your store. 
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Figure 5-5 shows the main page, the My Subscriptions page, to manage the 
customer’s interaction. 



Figure 5-5 New user registration and subscriptions to SMS messages mobile page 

Clicking the My Account link opens the My Account mobile Web page. This 
page provides the following useful features that you can use for mobile 
marketing: 

► My subscriptions: Useful for promotion messages or order notification 
messages. 

► My personal information: Useful for personal profile update, payment 
registration for quick checkout, and for language and currency selection. 

► My orders: Useful for order status and history. 

Mobile marketing features such as SMS and e-Marketing Spots can help you 
develop Web activities that implement and support your marketing strategy. 
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Using SMS functionality for mobile marketing 

IBM WebSphere Commerce V7 provides a J2EE Connector Architecture (JCA) 
adapter in the WebSphere Commerce messaging subsytem for SMS enablement 
and functionality. 

WebSphere Commerce provides the following key assets for SMS solutions: 

► User registration and account profile 

- Communication preference (SMS versus e-mail) 

- Opt-in and opt-out by notification types 

► Real-time marketing and notification 

- Marketing campaign through SMS 

- Promotion code for qualified shoppers 

- Order confirmation and fulfillment status 

- Text for store pickup 

► SMS adapter implementation 

- Hypertext Transfer Protocol (HTTP) and Parlay X interface support 

- SMS aggregator or Telecom Server 
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Figure 5-6 shows the logical model for SMS using WebSphere Commerce. 
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As part of your mobile marketing strategy you must create marketing content for 
SMS using the WebSphere Commerce Management Center. You can create the 
content of an SMS in a Dialog activity that uses the Send Message action to 
send a text message to a customer. Figure 5-7 shows the message creation. 


httDs://localhost:8000/lobtoolsfcmcfManaaementCenterMain?locale=en US 


K) Management Center 


£■“] Marketing |_ 

File Edit View Help 


is* h © § □ m a 


Search Results 

|o — *SMS Happy Discount 

Active Work 

* ' 

|H *SMS Happy Discount 


B Campaigns 

*Name © [SMS Happy Discount 

B Activities 


B Activity Templates 

Contenttype Text message for mobile device 

B E-mail Templates 

Text (United States English) [visit us on your mobile device and get 15% off) 

B E-Marketing Spots 


B Content 


B Customer Segments 



Figure 5-7 SMS Message for marketing purposes 


Enabling the SMS transport extends cross channel access by offering mobile 
device capabilities in WebSphere Commerce. You enable SMS transport using 
the following steps: 

1 . Add an SMS transport to the site using the Administration Console transports. 

2. Create and configure a message type using the Administration Console 
message types. 

3. Map the message type to a JSP file by editing the struts-config.xml 
configuration file. 

4. Test the new configuration to ensure that it works for your company. 

Step 1: Add an SMS transport 

To configure SMS transport: 

1 . Open the Administration Console, and select Site or Store on the 
Administration Console Site or Store selection page. 

2. Click Configuration 0 Transports. 
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3. Click Add to open the Add Transport page. 

4. Select the SMS transport that you want to add to the site. Then, click Add to 
accept the changes. When you add a transport method to a site, it is activated 
automatically. 

5. Select the SMS transport that you created, and click Configure. 

6. Complete the values for the parameters that correspond to the SMS transport 
that you created. Click OK. 

Figure 5-8 shows a sample of available transports in WebSphere Commerce. 

This image shows an SMS transport addition. 



Step 2: Create and configure a message type 

To create a message type: 

1 . Open the Administration Console and choose of the following options: 

- Site to assign a message type to a site 

- Store to assign a message type to a store 
For our example, we selected Site. 

2. Click Configuration 0 Message Types. The Message Type Configuration 
page opens. Select the message type to which you want to assign a 
transport, and click Change. 

In our example, we selected “Message for a received order.” 
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If the message type is not in the list, click New. The Message Transport 
Assignment page opens. If this is a new transport assignment, select the 
message type to which a transport is to be assigned from the Message Type 
list. 

3. Enter the transport configuration values in the appropriate fields. We selected 
the defaults for message severity range and selected SMS messages for 
Device format. 

Figure 5-9 shows a new message transport example. 



Figure 5-9 Message type configuration 

4. Click Next to configure the transport parameters for the specified message 
type. For our example, we accepted the defaults. 

5. Click Finish. The Message Type Configuration page displays, and the 
Transport Status Column should be Active. If the transport status is not active, 
the transport has been deactivated or removed. 
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Step 3: Mapping the message 

To modify the mapping of the message template to another JSP file, you can 
modify the Struts configuration file as follows: 

1. Open the struts-config. xml configuration file that is located in the 

WEB-INF/stores/ yourStoreName/data/ directory and add a new entry for the 
SMS message type that you created, as shown in Example 5-1 . 

Example 5- 1 Optional step sample 
<forward 

cl assName= "com. i bm. commerce. struts . ECActi onForwardname="yourView/0/-7" 
path="/yourJSPfi le. jsp"> 

<set-property property="resourceCl assName" 
val ue=" com. ibm. commerce. messaging.viewcommands.MessagingViewCommandlmpl 
"/> 

<set-property property="properties" val ue="storeDi r=no"/> <set-property 
property="interfaceName" 

val ue=" com. ibm. commerce. messaging.viewcommands.MessagingViewCommand"/> 
<set-property property="impl Cl assName" 

val ue=" com. ibm. commerce. messaging.viewcommands.MessagingViewCommandlmpl 
"/> 

<set-property property="direct" val ue="true"/> 

</forward> 


The configuration file uses -7 as the SMS device format, as defined in the 
DEVICEFMT database table. The path parameter in your new entry is 
mapped to a JSP file. 

2. Save your changes and close the configuration file. 

3. Restart the WebSphere Commerce server to apply your changes. 

Table 5-5 lists the SMS message templates that are implemented in JSP files in 
the Stores-Web Content directory. 

Table 5-5 SMS message templates 


Message name 

Template 

OrderAuthorized 

OrderAuthori zedSMS . j sp 

OrderReceived 

OrderRecei vedSMS . j sp 

OrderCancel 

OrderCancel edNoti fi cati onSMS. jsp 

OrderChanged 

OrderChangedNotificationSMS. jsp 

ReleaseShipNotify 

Rel easeShi pNoti fySMS .jsp 
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Step 4: Testing the SMS methodology 

The last step to SMS configuration is to test scenarios that are appropriate for 
your company. Testing reception of SMS messages requires the following 
components: 

► SMS gateway provider 

► Real Mobile Device 

Note: Mobile device simulators are not capable of receiving SMS messages. 

You can test message over Web service transports using the WebSphere 
Telecom Toolkit, which can simulate a Parlay X interface or an SMS gateway. 

Using e-Marketing Spots 

You can use e-Marketing Spots, which display marketing information to 
customers, to reserve space on mobile store pages. E-Marketing spots can 
display the following types of marketing information about store pages: 

► Content, such advertisements for promotions 

► Category recommendations 

► Catalog entry recommendations, including merchandising associations 

Using Web activities, you can control the information that displays in each 
e-Marketing Spot. Web activities can target different types of customers with 
different advertisements or recommendations dynamically, so that each 
customer viewing the e-Marketing Spot might not see the same thing. You do, 
however, need to manage any non-technical limitations because you are using a 
mobile device, such as using merchandising association. 

You can now create, change, and delete e-Marketing Spots using the Marketing 
tool in the Management Center. In addition, you can view impression and click 
statistics for each e-Marketing Spot that you use in a Web activity to evaluate the 
success of your marketing efforts. You can specify catalog entries, categories, 
and content as the default content for an e-Marketing Spot. 
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You name e-Marketing Spots descriptively so that the name includes the location 
and purpose, for example, HomePageRowlAds or CheckOutPageRecommendation. 
This unique naming helps to reduce confusion about on which page the 
e-Marketing Spot is located and the information that it displays. If necessary, you 
can add numbers to the name to differentiate between two e-Marketing Spots 
that display on the same page. 

Figure 5-10 lists examples of e-Marketing Spot names. You can use these spots 
to add customized options for e-Marketing Spot experiments. 


& 

E-Marketing Spots - List 


-Type 

* Name 

Description 

m 

MobileApparelFeaturedProducts 

Display suggestive sellings in the apparel top category mobile pag< 

m 

| MobileFurnitureFeaturedProducts 

Display suggestive sellings in the furniture top category mobile pai 

m 

MobileHomePage 

Display category recommendation in the mobile home page. 

m 

MobileHomePageFeaturedProducts 

Display suggestive sellings in the mobile home page. 

B 

MobileKitchenwareFeaturedProducts 

Display suggestive sellings in the kitchenware top category mobile 

m 

MobileTablewareFeaturedProducts 

Display suggestive sellings in the tableware top category mobile p< 


Figure 5-10 MobileHomePageFeaturedProducts e-Marketing Spot 


The move to the Management Center introduces several changes in behavior in 
e-Marketing Spots. If you used WebSphere Commerce Accelerator in the past to 
manage e-Marketing Spots, review the following information center topic to 
understand the differences: 

http : //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp 

Planning and implementing e-Marketing Spots 

When planning the purpose and location of e-Marketing Spots, the following 
people are typically involved: 

► The store developer who creates the JSP files for the store pages 

► The marketing manager who markets activities that use the e-Marketing 
Spots 

► The media designer who creates any graphics or text that displays in the 
e-Marketing Spots 

Collaboration ensures that the e-Marketing Spots are implemented in a way that 
provides adequate space and that retains the aesthetics of the mobile design. 
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To include an e-Marketing Spot on a store page, the store developer created a 
JSP file for the e-Marketing Spot. This JSP file specifies the following 
information: 

► The name of the e-Marketing Spot 

► The types of marketing information to display (that is, content, category 
recommendations, catalog entry recommendations, or a combination of these 
types) 

► The maximum number of each type of marketing information that the 
e-Marketing Spot can display at one time 

If the e-Marketing Spot snippet is generic, then these details are passed in as 
parameters to the JSP file for the store page, and they are not in the JSP file for 
the e-Marketing Spot. 

In the Management Center, you create the e-Marketing Spot using the Marketing 
tool to add the e-Marketing Spot to the marketing database so that you can 
specify it in Web activities to display marketing messages. 

Depending on the type of Web activity that you create, you might also need the 
following elements for your store: 

► Customer Segments 

► Promotions 

► Content 

Creating e-Marketing Spot experiments 

Marketing experiments ensure that your brand and promotional messages are as 
effective as possible. Marketing experiments enable marketing managers to run 
alternative paths within existing Web activities to determine whether small 
changes might improve the effectiveness of a Web activity. 

An experiment can include an experimental version of any marketing element, 
such as a target customer segment, an e-Marketing Spot that delivers the 
marketing message, or the marketing content. You create experiments by editing 
existing Web activities. 

By changing a single element on an experimental branch, you can experiment 
with the following elements: 

► The content that the Web activity displays 

Content experiments display different messages to customers to determine 
which message is more effective at driving sales. These messages can 
include marketing content, category recommendations, product 
recommendations, or merchandising associations. 
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► The e-Marketing Spot in which the Web activity displays 

An e-Marketing Spot experiment displays the same marketing message in 
two or more different e-Marketing Spots. You use e-Marketing Spot 
experiments to determine the best location on the mobile store pages for your 
marketing message. For example, you can display the same advertisement 
for patio furniture on the mobile home page and on the mobile Shopping Cart 
page to see which location gets better results. 

► The target customer segment 

Segment experiments display marketing content to a variety of customer 
segments to determine which segment is a better target for the message. 

► The Web activity that displays in a particular e-Marketing Spot 

Web activity experiments display different marketing activities, including 
content that targets different customer segments, in the same e-Marketing 
Spot to determine which Web activity is more effective at driving sales. 


5.2 Promotions 

Promotions enable you to offer customers incentives to purchase. WebSphere 
Commerce supports numerous types of promotions, such as price promotions, 
merchandise specials such as gifts with purchase and buy-one-get-one, and 
service promotions including reduced shipping costs. 

You can use the Promotions tool in the Management Center to create and 
manage promotions that support your site’s marketing campaigns. 

With a cross-channel solution, your company must also provide a seamless 
shopping experience to shoppers. So, with mobile commerce promotions, you 
need the same business logic that offers incentives to customers when certain 
conditions are satisfied on other channels, such as Web, CSR, Point-of-Sale 
(POS), and so forth. 

The central promotion engine evaluates promotions for customers while they 
shop on any channel, including mobile, so you can offer customers price 
incentives to drive sales, or promote a product. 

The evaluation process has several stages and involves a variety of components 
of the promotion engine. 
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Figure 5-1 1 shows a promotion sample created in the Management Center. 



Figure 5-11 Using a promotion for mobile sample 


This sample offers customers the following order-level promotion: 

► Customers receive 1 0% off orders of $1 00 or more. Figure 5-12 show these 
parameters. 
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► The promotion is available only during the first half of July. Figure 5-13 
displays a schedule for this sample. 



Figure 5-13 Promotion schedule 
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► This promotion is available only to registered customers. Figure 5-14 displays 
how the promotion is configured to use a special customer segment. 


Manage Promotion | Descriptions References 

> Promotion Properties 

l> Purchase Condition and Reward 

> Redemption Limits 

> Schedule 

Target Customer Segment 



Happy Savings (Read-only) 


Save and Close 


t Find and Add §) ® 


Customer segments * Type * Name 


* Name ] Description 


Qp Registered Customers Customers who have registered with the 


1 of 1 


Figure 5-14 Customer selection 
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► This promotion has a limit of one redemption per customer, as shown in 
Figure 5-15. 
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Using this sample, the customer uses a mobile device to make an online 
shopping purchase for $249. Figure 5-16 shows the mobile checkout page for 
this purchase. 


http://192.168.88.129/weba<mi' 



Figure 5-16 Online shopping, checkout process on Madisons Mobile Starter Store 

Because the purchase meets the rules of the promotion, the discount is applied 
as shown in Figure 5-17. 



Figure 5-17 Sample promotion, discount applied 
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5.3 Integration with a map service provider for the 
mobile Store Locator 

You can customize the Mobile Store Locator to integrate it with various map 
service providers, providing enhanced search and display capabilities on the 
Store Locator page. Integrating with map service providers on the Madisons 
mobile starter store gives an added advantage of Global Positioning System 
(GPS) functionality to find store locations based on the current geographic 
location. 


Note: A strong understanding of the map service provider’s API and mobile 
API is important to integrate its enhancements into the Store Locator 
successfully. Also, ensure that you complete the map service provider’s 
sign-up process to obtain a key, application ID, or other service-specific 
identifier. 


To integrate maps with the Store Locator in the Madisons mobile starter store: 

1 . Enable GPS Support: 

a. Implement the GPSSupport. jspf into the JSP file in which you want to 
implement GPS support. 

b. Detect whether GPS support is enabled for the current device. 

c. Display a button that uses the current location to perform a store location 
search. 

d. Before invoking the mStoreLocatorResultView: 

i. Set the geoCodeLati tude parameter to the current location’s latitude 
value. 

ii. Set the geoCodeLongi tude parameter to the current location’s longitude 
value. 

2. Integrate with the Geocoder API: 

a. Implement the Searchzi p code, jspf file into the JSP file in which you want 
to implement the Geocoder API. 

b. Obtain the user input from the zi pOrCi ty JavaServer Pages Standard Tag 
Library (JSTL) variable and invoke the geoCode API using this input. 

c. Parse or obtain the latitude and longitude values returned by the API 
provider. 
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d. Set the geoCodeLati tude JSTL variable to contain the resulting latitude 
value. 

e. Set the geoCodeLongi tude JSTL variable to contain the resulting longitude 
value. 

3. Integrate with a static map: 

a. Implement the ShowMap. jspf file into the JSP file in which you want to 
implement the static map. 

b. Locate the <di v> tag that includes the store_map_image value. 

<div id="store_map_image"> 

<img src="" width="238" height="184" 

al t="${physi cal Stores [i] . physical Storeldenti fi er .external Identi f i 
er} Map" /> 

</div> 

c. Set the value of the image src attribute to contain the static map URL. In 
the preceding code sample, the image src attribute contains a null value 
(“ ”) by default. 

4. Integrate with specific mobile devices. 

You can choose to integrate the maps with any mobile devices that support 
GPS and map applications. 

In this book, we provide detailed steps to integrate Google Map for iPhone in 
the next section. For integration with any other device, for example Blackberry, 
refer to the manufacturer’s documentation to add device-specific support. 

5.3.1 Example: Google Map integration for iPhone 

This example uses Google Maps API to present the integration of the mobile 
Store Locator with map service provider on iPhone. 


Note: To use the Google Map API, you need to sign up for an API key and 
obtain the Map API key. A single Maps API key is valid for a single domain. 
You must have a Google account to get a Map API key, and the API key is 
connected to your Google Account. To sign up for the API, visit: 

http://code.google.com/apis/maps/signup.html 


The Madisons Mobile Starter Store does not have any integration with map 
service providers. The Store Locator page takes the zip code or city as the input 
and displays the list of stores in the entered zip code or city, as illustrated in 
Figure 5-18. 
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Figure 5-18 Store Locator Results 
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Note: WebSphere Commerce database tables contain store location 
information used by the Store Locator. This information can be loaded in 
database using the loading utilities. You can find more information in the 
Madisons Mobile Starter Store: Loading store location data into WebSphere 
Commerce database tables topic in the WebSphere Commerce Version 7 
Information Center. 

After you load the information into database, you can modify it from 
WebSphere Commerce Accelerator. You can find more information in the 
WebSphere Commerce Accelerator: Changing store location information topic 
in the WebSphere Commerce Version 7 Information Center: 
http : //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?top 
ic=/com.ibm. commerce. user. doc/tasks/ts tlocin.htm 


To implement map integration, you need to: 

1 . Enable GPS support. 

2. Integrate with Google static map. 

3. Integrating with the iPhone map application. 

Enable GPS support 

This section describes the steps to enable the GPS support in the Madisons 
Mobile Starter Store for iPhone. You implement the GPSSupport. jspf file in the 
stores/WebContent/Madi sons/mobi 1 e/sni ppets/StoreLocator directory as 
explained in following steps: 

1. Create the GPSSupport. jspf skeleton file as shown in Example 5-2. 

Example 5-2 GPSSupport.jspf skeleton 

<script type="text/javascript"> 

//<! [CDATA[ 

//Add a check if geolocation API is supported 
//Add a function to capture the current location 
//Add a function to set the form elements with the captured 
location and submit the form 
//display the form 
//]]> 

</script> 
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2. Verify that the geolocation API is supported in the handset that is used. 
Replace the statement “Add a check if geolocation API is supported” 
shown in Example 5-2 with the code snippet shown in Example 5-3. 

Example 5-3 Check for geolocation API support 

if (navigator. geolocation) { 

//Add a function to capture the current location 

//Add a function to set the form elements with the captured 
location and submit the form 
//display the form 

} 


3. Capture the current location of the handset. You can set the maximum age, 
which is used if the GPS cannot locate the current position. Replace the 
statement “Add a function to capture the current location” shown in 
Example 5-3 with the code snippet shown in Example 5-4. 

Example 5-4 Capture current location 

function captureCurrentLocationQ { 

// Get location no more than 10 minutes old. 600000 ms = 10 
minutes. 

navigator . geol ocati on .getCurrentPosi ti on (showLocati on , showError, 
{enableHighAccuracy: true, maximumAge: 600000}) ; 

} 

function showError (error) { 

//If there is any error in capturing the current location, it 
will throw an alert to the user. 
alert(error.code + 1 1 + error. message) ; 

} 


4. Use the location captured in step 3 to populate the form with the latitude and 
longitude of the current location. After capturing the location, submit the form 
to get the search results based on the query that was entered. Replace the 
statement “Add a function to set the form elements with the captured 
location and submit the form” in shown in Example 5-3 with the lines of 
code shown in Example 5-5. 

Example 5-5 Code snippet to populate the GPS form 

function showLocation(position) { 

var fromForm = document. getElementById("store_locator_gps_form") ; 
var geoCodeLatitude = fromForm. geoCodeLatitude; 
var geoCodeLongitude = fromForm. geoCodeLongitude; 

geoCodeLatitude. val ue = position. coords. latitude; 
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geoCodeLongitude.val ue = position. coords. longitude; 

fromForm. action = "mStoreLocatorResultView"; 
fromForm.submit() ; 


Example 5-6 gives sample code for the form that is used in the Madisons Mobile 
Starter Store. It takes the search radius as input from the user. Replace the line 
“display the form” in Example 5-3 on page 212 with the lines of code in 
Example 5-6. 

Example 5-6 Code snippet to implement the form 

this. document . wri te ( "<f orm i d= ' store_l ocator_gps_form 1 method= ' post 1 
action=' ’>") ; 


this. document. write("<i nput type='hidden' id='storeId' name= ' storeld 1 
value='${WCParam.storeId} 1 />"); 


this. document. write("<i nput type='hidden' i d= ' 1 angld 1 name= ' 1 angld 1 
value='${WCParam.langId} ' />"); 

this. document. write("<i nput type='hidden' i d= ' catal ogld 1 
name='catalogId' value='${WCParam.catalogId} 1 />"); 

this. document. write("<i nput type='hidden' i d= ' productld 1 
name='productId' value='${WCParam. productld} 1 />"); 


this. document. write("<i nput type='hidden' id='fromPage' name='fromPage' 
value='${WCParam.fromPage} ' />"); 

this. document. write("<i nput type='hidden' id='geoCodeLatitude' 
name='geoCodeLatitude' value='' />"); 

thi s.document.wri te ( "<i nput type= ' hidden ' i d= ' geoCodeLongi tude 1 
name='geoCodeLongitude' value='' />"); 

this. document. write("<i nput type='hidden' id='uom' name='uom' 
value='KTM' />"); 


this. document. write("<i nput type='hidden' id='whichSearch' 
name='whichSearch' val ue= 1 useGPS 1 />"); 


thi s.document.wri te ( "<di vxfmt :message key= ' MSTLOC_FIND_ME_MESSAGE ' 
bundle= 1 ${storeText} 1 /></div>") ; 
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thi s .document .write ("<1 abel for= ' radi us ' ><di v><fmt :message 
key= , MSTLOC_SELECT_RADIUS' bundl e= 1 ${storeText} 1 /></di v></ 1 abel>") ; 

this. document. write("<div><select i d= 1 radi us ' name= 1 radius 1 
cl ass= 1 col oured_i nput ' ; 

this.document.write("<option val ue= 1 5 'xfrnt: mess age 
key= 'MSTL0C_RADIUS_5 1 bundl e= 1 ${storeText} 1 /></option>") ; 

this.document.write("<option val ue= 1 10'><fmt:message 
key='MSTL0C_RADIUS_10 l bundle='${storeText} ' /></option>") ; 

this.document.write("<option val ue= 1 15'><fmt:message 

key= 1 MSTL0C_RADIUS_15 1 bundle='${storeText} ' /></option>") ; 

this. document . wri te ( "<opt i on val ue= 1 20 ' ><fmt :message 
key='MSTL0C_RADIUS_20 l bundle='${storeText} 1 /></option>") ; 

this. document. write(" </select> <fmt:message 

key= 'MSTLOC_RADIUS_UNIT 1 bundl e= 1 ${storeText} ' /></div>"); 

this. document. write("<i nput type= 1 submi t ' id='find_me' name= 1 f i nd_me 1 
oncl ick= 1 javascript:captureCurrentLocation() ; return false; 1 
class='input_button' value='<fmt:message key='MSTLOC_FIND_ME' 
bundle= 1 ${storeText} ' />' />"); 

thi s.document.wri te ( "<di v cl ass= 1 bol d 1 ><fmt :message key= ' MSTL0C_0R 1 
bundle= 1 ${storeText} 1 /></div>") ; 

thi s. document. wri te("</form>") ; 


On an iPhone, the Store Locator page looks similar to that shown in Figure 5-19 
after implementing the GPSSupport. jspf file. 
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Integrate with Google static map 

Implement the ShowMap.jspf file located in the 

stores/WebContent/Madi sons/mobi 1 e/sni ppets/StoreLocator directory as 
shown in Example 5-7. Include this code in the JSP where you want to display 
the map for a single store or multiple stores. 

Example 5-7 Display Google map for a single store 
<c:set var="latLong" 

val ue="$ {physical Stores [i] . location Inf o. geoCode. 1 at i tude} ,${physi cal Sto 
res[i] .locationlnfo. geoCode. longitude}" /> 

<c : url var="stati cMapURL" val ue="http : //maps .googl e . com/stati cmap"> 
<c:param name="center" val ue="${latLong} " /> 

<c:param name="zoom" value="12" /> 

<c:param name="size" val ue="238xl84" /> 

<c:param name="maptype" val ue="mobi 1 e" /> 

<c:param name= "markers" val ue="${l atLong} , rede" /> 

<c:param name="key" val ue=" {MAP_KEY } " /> 

</c:url> 

<di v id="store_map_image"><img src="${fn:escapeXml (staticMapURL) } " 
width="80%" height="184" 
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al t="$ { physi cal Stores [i ] . physical Storeldenti f i er. external Identi f i er} 
Map" /></div> 


To complete the process of implementing the map that you want to display for a 
single store or multiple stores, follow these steps: 

1 . Obtain the latitude and longitude values for the store that you want to locate 
on map. 

2. Create the URL to Google static map. You can find more information about 
the URL the Google Maps API. 

a. Pass the comma separated value of latitude and longitude to the “center” 
parameter. 

b. Set the zoom to 12. You can set the zoom to any value between 1 and 19, 
based on your requirement. 

c. Set the size to 238x184. You can set the size to any value, depending on 
your requirement. 

d. Set maptype as mobile. 

e. Set markers to the latitude, longitude, and marker color plus alphanumeric 
indicator of all the locations that you want to mark on the map. If you want 
to plot multiple locations on the map, then separate these values with a 
vertical bar ( | ) character, as shown in Example 5-8. 

f. Set key to the value that you received after you registered your domain 
with Google. 

3. Locate the <di v> tag that includes the store_map_image value. Set the value 
of <img src> attribute to contain the static map URL. See Example 5-8. 

Example 5-8 Implement static map URL 
<c:set var="markers" value="" /> 

<c:set var="latLong" val ue="${geoCodeLatitude} ,${geoCodeLongitude} " 
/> 

<c:forEach var="i" begin="0" end="${resul tStoreNum-1} "> 

<c:choose> 

<c:when test="${markers == 

<c:set var="markers" 

val ue="${ physi cal Stores [i] .location Info. geoCode. latitude} ,${physical 
Stores [i] .location Info. geoCode. longitude} ,green${i+l} " /> 

</c:when> 

<c:otherwise> 

<c:set var="markers" 

val ue="$ {markers} | $ { physi cal Stores [i] .location Info. geoCode. latitude} 
,${ physi cal Stores [i] .locationlnfo. geoCode. longitude} ,green${i+l} " /> 
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</c:otherwise> 

</c:choose> 

</c:forEach> 

<c : url var="stati cMapURL" val ue="http : //maps .googl e . com/stati cmap"> 
<c:param name="center" val ue="${latLong} " /> 

<c:param name="zoom" value="9" /> 

<c:param name="size" val ue="238xl84" /> 

<c:param name="maptype" val ue="mobi 1 e" /> 

<c:param name="markers" val ue="${markers} " /> 

<c:param name="key" val ue=" {MAP_KEY } " /> 

</c:url> 

<di v id="store_map_image"><img src="${fn:escapeXml (staticMapURL) } " 
width="80%" height="184" alt="" /></div> 


As a result of integration with Google static map, the search results page for the 
Madisons Mobile Starter Store looks similar to that shown in Figure 5-20. 
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Integrating with the iPhone map application 

You can integrate the mobile storefront with the iPhone map application. On the 
Store Locator results page, when a user clicks View Map, control is taken to the 
iPhone map application. You can implement this functionality as follows: 

1. Update the ViewMap. jspf file to contain the required logic to invoke the default 
iPhone map application with the code snippet shown in Example 5-9. 

Example 5-9 Code snippet for ViewMap.jspf file 
<c:choose> 

<c:when test="${ lempty physicalStore}"> 

<c:set var="thePhysi cal Store" val ue="${physi cal Store} " /> 
</c:when> 

<c:otherwise> 

<c:set var="thePhysi cal Store" val ue="${physi cal Stores [i] } " /> 
</c:otherwise> 

</c:choose> 

<c:if test="${fn:startsWith(header['User-Agent'] , 1 i Phone' )} "> 

<c:set var="storeLati tude" 

val ue="${thePhysi cal Store. 1 ocati on Info. geoCode. 1 at i tude} " /> 
<c:set var="storeLongitude" 

val ue="${thePhysi cal Store. location Info. geoCode. longitude}" /> 
<c:set var="storeAddress" 

val ue="${thePhysi cal Store. 1 ocati on Info. address . address Li ne[0] } , 

$ { thePhysi cal Store. location Info. address. city} , 

$ { thePhysi cal Store. 1 ocati on Info. address . stateOrProvi nceName} " /> 
<c:set var="storeName" 

val ue="(${ thePhysi cal Store. physical Store Identifier. external Identi 
fier})" /> 

<c : url var="mapsGoogl eURL" val ue=" http : //maps . googl e . com/maps "> 
<c:param name="v" value="2" /> 

<c:param name="t" val ue="mobi 1 e" /> 

<c:param name="mrt" value="loc" /> 

<c:param name="l 1 " val ue="${storeLati tude} ,${storeLongi tude} " 

/> 

<c:param name="q" val ue="${storeAddress} ${storeName} " /> 
</c:url> 

<li><span class="bul let">&#187; </span><a 

href = "$ { f n : escapeXml (mapsGoogl eURL) } "><fmt :message 

key= 1 MST_V I EW_MAP 1 bundl e= 1 ${storeText} 1 /></a></li> 

</c : i f > 


Chapter 5. Mobile commerce features in WebSphere Commerce V7 219 



2. Detect the device as an iPhone with the following line: 

<c : i f test="$ { fn : startsWi th (header [ 1 User-Agent ' ] , 1 i Phone ')}"/> 

3. Obtain the store location information from the store location variable with the 
following line: 

physicalStores[i] .locationlnfo. address. addressLi ne[0] returns 
address line 1 of the store location. 

4. Construct the Google Maps URL. 

5. Include the ViewMap.jspf file in the StoreLocatorResults.jsp file using the 
following line: 

<%@ include file=". ./Snippets/StoreLocator/ViewMap.jspf" %> 

After completing these steps, when a user clicks View Map in the Search results 
page, the map is displayed as shown in Figure 5-21 . 



Figure 5-21 Map results 
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5.4 Buy on mobile device and select shipping address 


As mentioned in “Functions not included in the Madisons Mobile Starter Store” 
on page 51 , the version of Madisons Mobile Starter Store that ships with IBM 
WebSphere Commerce V7 includes only checkout pages that allow shoppers to 
buy online and pick up in a store. As such, a shopper cannot buy on the mobile 
device and ship the products to a selected address. This type of functionality is 
also known as endless aisle in the store, because it allows the shopper to browse 
and check out products that might be available online but not in the store, while 
the shopper is in a brick-and-mortar store. 

In this section, we explain how you can amend the Madisons Mobile Starter 
Store with endless aisle functionality. 


Note: The steps in this section assume that you have the Madisons starter 
store published with the Madisons mobile add-on starter store. The Madisons 
mobile starter store is published by default on a standard installation of IBM 
WebSphere Commerce V7 Developer Edition. However, if you have cleaned 
your toolkit using the resetstores and resetdb scripts, you need to publish the 
Madisons.sar followed by the MadisonsMobi le. sarto complete the steps in the 
following sections. 


5.4.1 Standard checkout page flow for Madisons Mobile Starter Store 

The standard page flow for checkout by guest shoppers that have not yet 
selected a preferred store in Madisons Mobile Starter Store, as it ships with IBM 
WebSphere Commerce V7, is outlined in Figure 5-22 on page 223. The numbers 
in Figure 5-22 refer to the following summary: 

1 . The product page where the shopper clicks Add to Cart to add the product to 
the Shopping Cart. 

2. The Shopping Cart that is presented after a shopper clicks Add to Cart or 
selects the Shopping Cart link that is present in the footer of all pages. The 
shopper can click Proceed to Checkout to transition to the next page. 

There are two versions of this page: 

- The regular Shopping Cart that shows the products that the shopper has 
added. 

- The page for an empty cart, showing a message that the shopper has not 
added products to the cart. 
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Note: The Shopping Cart page for the standard Madisons mobile starter 
store in IBM WebSphere Commerce V7 has a single radio button, Pick Up 
at Store, just above the Proceed to Checkout button. We will add an 
additional radio button that allows shoppers to elect to have the ordered 
items shipped to a shipping address of their choice. 


3. The Sign in or Checkout page allows registered shoppers to sign in to retrieve 
settings or guest shoppers to check out without signing in. In this scenario, 
the shopper clicks Continue Checkout to check out as a guest shopper. 

4. The Store Locator is where the shopper enters a zip or postal code or a city 
name and clicks Continue Checkout to transition to the next page. 

5. The Store Locator search results lists store that match the search terms 
entered on the Store Locator page. Clicking Add to Store List and then 
Continue Checkout opens the next page. 

6. The Your Store List opens again with the stores selected in the previous page. 
On this page, shoppers select the store from which to pick up products, and 
then click Continue Checkout. 

7. The billing address form opens. Shoppers can enter billing information, and 
click Continue Checkout. 

8. After editing the billing address, the billing address selection page is shown 
with the entered address. The shopper can then select the address and click 

Continue Checkout. 


Note: In this scenario, we check out with a new guest shopper account. If 
using an existing account with a predefined addresses, the billing address 
selection page is shown at step 7. Whether this page is shown is controlled 
using the conditional JavaScript on the billing address selection page. 


9. The payment method page opens, from which shoppers can select the 
preferred payment method, including the Pay in Store method, enter the 
payment details, and click Continue Checkout. 

10. The order summary page opens. This page is the final page before the order 
is submitted. This page allows the shopper to verify the pick-up location, 
billing address, payment method, and order details before finalizing the order 
by clicking Place Your Order. 

1 1 .After the order is submitted, the order confirmation page shows the final 
confirmation that the order is received and is being processed. 
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5.4.2 Checkout with shipping for Madisons Mobile Starter Store 


As mentioned earlier, we will amend the process outlined in 5.4.1 , “Standard 
checkout page flow for Madisons Mobile Starter Store” on page 221 , to provide 
the shopper the option to ship products to a selected address. This alternate 
scenario is outlined in Figure 5-23. The main difference between the flow in 
Figure 5-22 on page 223 and that in Figure 5-23 is that the store selection pages 
are replaced with shipping selection pages. 
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The numbers in Figure 5-23 refer to the following summary: 

1 . The product page if the page from where the shopper can click Add to Cart to 
add the product to the shopping cart. We will not change this page. 

2. The shopping cart is the page that is presented after a shopper clicks Add to 
Cart or selects the Shopping Cart link that is present in the footer of all 
pages. The shopper can click Proceed to Checkout to transition to the next 
page. 

There are two versions of this page: 

- The regular shopping cart that shows the products that the shopper has 
added. We will change this page to add the option of selecting a shipping 
option in addition to the standard BOPIS option. Figure 5-24 shows a 
comparison of the standard page and the new page. 

- This is a page for an empty cart that shows a message that the shopper 
has yet to add products to the cart. We will not change this page. 


1® MADISONS MOBILE 


1® MADISONS MOBILE 

Sion Out 

Shopping Cart 

Enzi Espresso Machine, Violet 

SKU: EI-0101V 
Price: $179.99 

Q»h 1 

» Move to Wishlist 

Shopping Cart 

Enzi Espresso Machine, Violet 

SKU: EI-0101V 
Price: $179.99 

Qty=H 1 

» Remove 
$ Move to Wishlist 

Promotion Code: 


Order Subtotal: $179.99 


Promotion Code: 

Discount: ($18.00) 


Order Subtotal: $179.99 

Order Total: $161.99 


Discount: ($18.00) 

Update Order Total | 


Order Total: $161.99 



Update Order Total 1 

(• Pick Up at Store 


£ 1 

Proceed to Checkout | 


Proceed to Checkout 



Pick Up at Store | 



Shop Online | 


Figure 5-24 The standard (left) and the new shopping cart page (right) 


3. The next page is the Sign in or Checkout page, which allows registered 
shoppers to sign in to retrieve settings or guest shoppers to check out without 
signing in. In this scenario, the shopper clicks Continue Checkout to check 
out as a guest shopper. We will not change this page. 
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4. The new shipping address page opens from where the shopper can enter 
shipping information and click Continue Checkout. 

5. After editing the shipping address, the shipping address selection page opens 
and shows the entered address. The shopper can then select the address 
and click Continue Checkout. 

Note: In this scenario, we check out with a new guest shopper account. If 
using an existing account with a predefined addresses, the shipping 
address selection page is shown at step 4. Whether this page is shown is 
controlled using conditional JavaScript on the shipping address selection 
page. 

6. The new shipping options page opens from where the shopper can select the 
courier, delivery speed, an optional shipping date, and whether there are 
special shipping instructions. 

7. The new shipping instructions page is shown only if the shopper selects to 
specify shipping instructions on the previous page. Here the shopper can 
specify free-text instructions, such as “Leave on porch if nobody is home.” 

8. The standard billing address selection page allows the shopper to select the 
billing address. In our scenario, the shopper has already created a shipping 
address, so the shopper can select this as the billing address as well and click 
Continue Checkout. 

9. The payment method page allows the shopper to select the preferred 
payment method and to enter the payment details, and then click Continue 
Checkout. Note that because we are not picking up in the store, the pay in 
store method is not on this page. 

10. This is the order summary page, which is the final page before the order is 
submitted. This page allows the shopper to verify the pick-up location, billing 
address, payment method, and order details before finalizing the order by 
clicking Place Your Order. We will change this page to display the shipping 
address rather than the store address if selected. 

1 1 .After the order is submitted, the order confirmation page shows the final 
confirmation that the order is received and is being processed. We will 
change this page to display the shipping address rather than the store 
address if selected. 
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5.4.3 Analyze the existing Madisons Mobile Starter Store code 

As described in 5.4.2, “Checkout with shipping for Madisons Mobile Starter 
Store” on page 224, we need to modify a number of pages as well as introduce 
some new pages. In this section, we analyze the existing pages to determine the 
files that we need to modify. 

Summary of modified pages for shipping checkout 

In the overview of the current pick up in store checkout flow and the online 
shopping flow, we noted that we need to modify the pages as follows: 

► Shopping cart (not empty) 

Add an option to Shop Online in addition to the existing Pick Up at Store 
option. 

► Payment method 

Ensure that Pay in Store is removed when choosing the Shop Online option 
on the shopping cart page. It is apparent in the analysis of this page that we 
also need to modify it to support separate shipping and billing addresses. 

► Order summary 

Add logic to display the shipping address and options when appropriate. 

► Order confirmation 

Add logic to display the shipping address and options when appropriate. 

► Breadcrumb trail include 

The Madisons mobile starter store generates the breadcrumb trail on top of 
all pages from a central include file names BreadCrumbTrailDisplay.jspf. 
We need to amend this file to ensure that the breadcrumb trail on new pages, 
as well as on existing pages in the modified flow, is shown correctly. 

► Sign in or checkout page 

We need to update this page to redirect correctly in the new checkout flow. 

Summary of new pages for shipping checkout 

In addition to the modifications that we have outlined thus far, we need to create 
the following new pages: 

► Shipping address selection 

Similar to the billing address selection page. 

► Shipping address create/edit 

Similar to the billing address create/edit page. 
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► Shipping method selection 

A new page for the shopper to select the shipping options. 

► Shipping instructions create/edit 

A new page for the shopper to enter their delivery instructions. 

In the following sections, we analyze the existing pages to understand how we 
can best implement these changes. 

Analyze the current checkout pages 

In this section, we go through the existing checkout process for Madisons Mobile 
Starter Store to analyze the existing pages to determine the best approach to 
add shipping address handling to the process: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 
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3. In the Servers view, right-click WebSphere Commerce Test Server, and 
select Start, as shown in Figure 5-25. 


0- OrganizationAdministrat 
0- C7 SiteAdministration 
0 - C7 Stores 
0 §3 WC 

0 £7 WebServicesRouter 
0 £7 WebSphereCommerceSt 
0 £7 WebSphereCommerceSe 

New ► 

Open F3 

Show In Alt+Shift+W ► 

HI Copy Ctrl+C 

Paste Ctrl+V 

X Delete Delete 

Rename F2 

p Debug 




£>' Profile 

Stop Ctrl+Alt+S 

-> Publish Ctrl+Alt+P 

Clean... 

Add and Remove Projects. . . 

Monitoring ► 

Q Create tables and data sources 

<1 

Reconnect debug process 

Server configuration ► 

Universal test client ► 

Administration ► 

|type filter text 

« Servers 23\ P 


Properties 

Alt+Enter 


Problems Tasks Pi 


No consoles to display at this tin 


J & 


Figure 5-25 Starting the server 


The server state changes as shown in Figure 5-26. 



Figure 5-26 Server in the starting state 
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After a while, the server status changes to Started, as shown in Figure 5-27. 
In our case, the server took approximately 6 minutes to start. 



Figure 5-27 Server in the started state 

4. Open a Web browser and navigate to a product page. We used Mozilla 
Firefox to navigate to a product in the catalog. 


Important: Although you are browsing mobile pages, you need to use a 
desktop Web browser in this example, because you must inspect details 
about the application, such as the source code, which are not usually 
available on a mobile browser or simulator. 

Also, ensure that you perform these steps in a new Web browser instance, 
because the flow assumes that you are checking out as a guest user with 
no existing addresses in the address book. 


We chose the violet Enzi Espresso Machine at the following URL: 

http : //I ocal host/webapp/wcs/stores/servl et/mProductl_10051_10051_-l 

10074_10345_10053_10053_catNav 

Note: This link worked in our environment with the standard starter stores 
deployed at the time of installing IBM WebSphere Commerce V7 
Developer Edition. If you published the Madisons Starter Store manually or 
changed the catalog, this link might not work for you. In this case, navigate 
the catalog to find a product that is in stock both online and in one of the 
brick-and-mortar stores. The violet Enzi Espresso Machine is in the Coffee 
Makers subcategory of the Kitchenware top category. 


5. From the product page click Add to Cart. 

6. The shopping cart page opens with the product shown in the cart. Because 
we need to add an extra radio button for shipping checkout, we must 
determine the JSP that renders this page. Thus, we note the URL that shows 
in the browser’s address bar. 

In our scenario, we saw the following URL (everything following the krypto 
parameter in bold formatting is excluded for brevity): 

https : //I ocal host/webapp/wcs/stores/servl et/mOrderltemDi spl ay?produc 
tld=12245&catal ogld=10301&categoryld=10174&l angld=-l&storeld=10051 
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We highlighted the relevant information that we use later to determine to 
which JSP this view name corresponds. 


Note: The exact values and order of parameters might be different in your 
configuration. 


7. Now, we need to determine how we can add another radio button by 
analyzing the source code of the page as follows: 

a. Use your browser’s method for viewing the source code: 

• In Mozilla Firefox, select View 0 Page Source. 

• In Microsoft® Internet Explorer, select View 0 Source. 

We used Mozilla Firefox, so we selected View 0 Page Source. 

b. The page source opens in a separate window. Search for the text on the 
existing radio button, for example: 

Pick Up at Store 

In the standard page source window in Mozilla Firefox, you can search by 
pressing Ctrl+F. 

The code snippet shown in Example 5-10 should display. (We reformatted 
the code in this example to improve readability.) 

Example 5-10 The code for the submit button on the Shopping Cart page 
<div id="shipping_options"> 

<div class="radio_container"> 

<input type="radio" name="shi ppi ng_option" 
id="pick_up_at_store" checked /> 

<1 abel for="pick_up_at_store">Pick Up at Store</label> 

</di v> 

<button type="button" 

oncl i ck="wi ndow. 1 ocati on . href = ' http : //local host/webapp/wcs/stores/se 
rvl et/mCheckoutLogon?catal ogld=10051&l angld=-l&storeld=10051' ">Proce 
ed to Checkout</button> 

</di v> 


The highlighted code in Example 5-10 shows that the Madisons mobile 
starter store is designed to always go to the sign in or check out page. 
Thus, that page must control the next page in the checkout flow. 

To add the additional Shop Online option, we need to be able to control to 
which page the mCheckoutLogon page redirects. We discuss the possible 
options for doing this task later in 5.4.4, “Design new shopping flow” on 
page 239. 
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8. Close the source view, and click Proceed to Checkout to continue the 
checkout process. 

9. The sign in or checkout page opens. Click Continue Checkout to check out 
as a guest shopper. 

1 0. The Store Locator opens. Enter Markham in the entry field, and click Continue 
Checkout. 


1 1 .A list of stores in Markham opens. Find the Markham Centre entry, and click 

Add to Store List. 


12. The page refreshes, and the link under Markham Centre changes to read 
“Remove from Store List” to signify that the store was added. Scroll down to 
the bottom of the page, and click Continue Checkout. 

13. You are presented with the store list with the Markham Centre location as the 
only option. Select Markham Centre, and click Continue Checkout. 

14. The billing address details page opens. Because you need to create a page 
very similar to this page, take note of the URL of this page from the browser’s 
address bar. In our scenario, we noted the following URL: 

http ://l ocal host/webapp/wcs/stores/servl et/mOrderBi 1 1 i ngDetai 1 s?cata 
1 ogld=10051&orderld=11007&l angld=-l&storeld=10051 


15. In the billing address page, enter a new billing address, and click Continue 
Checkout. We entered the following information: 


Nick Name: 

First Name: 

Last Name: 

Street Address 1 : 
Street Address 2: 
City: 

Country/Region: 

State/Province: 


ITSO 

IBM Corporation 
International Technical 
Dept. HYTD Mail Station 
2455 South Road 
Poughkeepsie 
United States 
New York 


Zip code/ Postal code: 12601-5400 
Phone number: 1-800-IBM-HELP 

E-mail: redbooks@us.ibm.com 


Support Organization 
P099 


16. The billing address selection page opens with the address that you just 
entered. Because you need to create a page very similar to this page, take 
note of the URL from the browser’s address bar. We noted the following URL. 
We left out the krypto parameter for brevity: 

https: //local host/webapp/wcs/stores/servl et/mOrderBi 1 1 ingAddressSele 
ction?catalogld=10051&l angld=-l&storeld=10051 
Because the page does not have address Id parameters, the JSP must 
retrieve the shopper’s address book information in the JSP directly. 
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17. Select the billing address that was created in step 14, and click Continue 
Checkout. We selected ITSO, and clicked Continue Checkout. 

18. The payment method page opens. Take note of the URL of this page from the 
browser’s address bar. In our example, we saw the following URL: 

https ://l ocal host/webapp/wcs/stores/servl et/mOrderPaymentDetail s?l an 
gld=-l&storeld=10051&catal ogld=10051&addressld=11402 
We will need this URL at a later step in the analysis where we analyze the 
struts configuration. 

Note that the address ID is passed from the billing address selection page to 
this page. This address ID shows that the billing address is most likely not 
updated by the billing address selection page itself but, rather, is updated as 
part of a later step. This information is important, because we need to 
determine how best to add the shipping address to the order. 

In your environment, the address Id parameter value will likely be different. 

19. Because we observed that the billing address information has not yet been 
submitted to a controller command or an order service, we need to verify 
whether this page performs the update by viewing the page source of the 
current page using the browser’s view source function. 

We used Mozilla Firefox, so we selected View 0 Page Source. 

20. A page source window opens. Search for the following text: 

Continue Checkout 

We pressed Ctrl+F and then entered Continue Checkout in the search bar at 
the bottom. The HTML code in Example 5-1 1 is displayed. 

Example 5- 1 1 Continue Checkout button code from the payment details page 

<input type="button" name="proceed_to_checkout" 
id="proceed_to_checkout" oncl ick="submitPaymentInfo() 
value="Continue Checkout" /> 


The highlighted code in Example 5-1 1 shows that the JavaScript function 
submitPaymentlnfo is invoked when the shopper clicks the button. We next 
need to analyze the source code of this function. 

21. Search for the text function submitPaymentlnfo. We pressed Ctrl+F and then 
entered function submi tPaymentlnfo in the search bar at the bottom. The 
HTML code in Example 5-12 displayed. 

Example 5-12 The source code for the submitPaymentlnfo JavaScript function 
function submitPaymentlnfoQ { 

var paymentMethods = document .getEl ementsByName( 1 payMethodId_radio' ) ; 
for(var i = 0; i < paymentMethods. length; i++) { 
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if (paymentMethods[i] .checked) { 

if (paymentMethods[i] .value == "credit_card") { 

document. get El ementBy Id ("payMethodId_credi tcard") .val ue = 
document. get El ementBy Id ("card_type") .val ue; 

document . get El ementBy Id ("paymentmethodformcredi tcard") . submi t () ; 

} 

else { 

document. get El ementBy Id ("payMethodId_pay instore") .val ue = 
paymentMethods[i] .value; 

document . getEl ementBy Id ("paymentmethodformpayi nstore") . submi t () ; 


} 

} 

} 


The highlighted code in Example 5-12 shows that, depending on the payment 
type, either the payment_method_form_credi tcard or the 
payment_method_form_payi nstore form is submitted. We analyze the latter to 
understand the target for the form and the parameters submitted. 

22. Search for the text id="payment_method_form_payi nstore". We pressed 
Ctrl+F and then entered id="payment_method_form_payi nstore" in the 
search bar at the bottom. The HTML code in Example 5-13 displayed. 

Example 5-13 HTML source code for the payment_method_form_payinstore form 

<form id="payment_method_form_payi nstore" action="OrderChangeServicePIAdd"> 

<fieldset> 

<input type="hidden" name="langld" value="-l" /> 

<input type="hidden" name="storeId" value="10051" /> 

<input type="hidden" name="catal ogld" val ue="10051" /> 

<input type="hidden" name="payMethodId" value="" id="payMethodId_payinstore" /> 
<input type="hidden" name="URL" 

val ue="http://l ocal host/webapp/wcs/stores/servl et/mOrderShi ppi ngBi 1 1 i ngSummaryVi ew?ca 
tal ogld=10051&l angId=-l&storeId=10051"/> 

<input type="hidden" name=" pi Amount" value="161.99000"/> 

<input type="hidden" name="bil 1 ing_address_id" value="11902"/> 

<input type="hidden" name="addressld" val ue="11902"/> 

<input type="hidden" name="errorViewName" val ue="mOrderPaymentDetai 1 s"/> 

<input type="hidden" name="authToken" 

val ue="3%2czzgqxWRhBRPd%2b4HtQmI%2fwb3TtG4%3d" /> 

</fieldset> 

</form> 


The HTML in Example 5-13 shows that the information in the hidden fields 
within the form is submitted to the OrderChangeServicePIAdd struts action. 
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This action adds a payment instruction to the order with the specified payment 
information. We notice that both the address Id and the bi 1 1 ing_address_id 
are specified as parameters. However, the action uses only the 
bi 1 1 ing_address_id. 

Also, we note that the authToken request parameter is specified as a hidden 
field in the form as part of the cross-site request forgery (CSRF) protection 
feature, which works only for SSL protected pages. As such, we must ensure 
that the pages that we introduce require SSL. 

23.Close the source code window. You can use Ctrl+W to close the window. 

24.0n the payment method page, select Pay in Store, and click Continue 
Checkout. 

25. The order summary page opens as shown in Figure 5-28. Make a note of the 
URL in the browser’s address bar. We saw the following URL. We left out the 
krypto parameter for brevity: 

http: //local host/webapp/wcs/stores/servlet/mOrderShippingBill ingSunm 
aryView?catalogId=10051&langId=-l&storeId=10051 
We need to change this JSP to display the shipping address in place of the 
store location if the shopper has selected a shipping address. 


^'MADISONS MOBILE SiflOia 


Order Summary 

Review your order and select th 
“Place Your Order" button at the 
of the page. 


Store Location 


Markham Centre 
Markham Centre 
8200 Warden Ave 
Markham Ontario 
Canada L6G 1C7 
admin@madisons.ci 


■ Change Store 


Billing Address 


ITSO 


IBM Corporation International Technical 
Support Organization 
Dept. HYTD Mail Station P099 2455 
South Road 

Poughkeepsie New York 
United States 12601-5400 
1-800-IBM-HELP 
redbooks@us.ibm.com 

» Edit 


Payment: Pay later 
Amount: $161.99 


Payment: Pay later 
Amount: $161.99 


» Edit 

Order Subtotal: $179.99 
Discount: ($18.00) 

Tax: $0.00 
Shipping: $0.00 

Order Total: $161.99 

Place Yout Order I 


Figure 5-28 The order summary page (shown here split in three parts) 


26.Click Place Your Order. 
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27.The order confirmation page opens. Make a note of the address of this page. 
In our example, we noted down the following URL. We left out the krypto and 
other parameters for brevity: 

https ://localhost/webapp/wcs/stores/servlet/mOrderShippingBillingCon 
firmationView?catal ogld=10051&l angld=-l&storeld=10051 
We will change the order confirmation page in the same way as the order 
summary page, replacing the store location with the shipping address if one 
was selected during checkout. 


We now have the information necessary to change the pages. Table 5-6 
summarizes our analysis. 

Table 5-6 Values discovered during the analysis 


Information 

Value 

Store ID 

10051 

Shopping Cart view 

mOrderltemDisplay 

Billing address selection view 

mOrderBillingAddressSelection 

Billing address create view 

mOrderBillingDetails 

Payment details view 

mOrderPaymentDetails 

Order summary view 

mOrderShippingBillingSummaryView 

Order confirmation view 

mOrderShippingBillingConfirmationView 


Analyze struts configuration for checkout pages 

We now use the information that we gathered in our analysis to determine the 
JSPs that we need to modify by analyzing the struts configuration files as follows: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 

3. In the Enterprise Explorer, expand and right-click Stores 0 WebContent 0 
WEB-INF 0 struts-config-ext.xml. 

4. From the context menu, select Open With 0 Text Editor. 
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5. The struts-config-ext.xml file opens in a text editor. For each of the views 
listed in Table 5-6, complete the following steps: 

a. Press Ctrl+F to open the Find/Replace dialog box. 

b. In the Find/Replace window, enter the first view name, for example, 
mOrderltemDi splay, ensure that Wrap search is selected, and click Find. 
An excerpt similar to Example 5-14 is displayed. (We reformatted the XML 
in Example 5-14 for improved readability.) 

Note that the store ID after the view name (the two are separated with a 
forward slash character) corresponds to the store ID that we noted in 
Table 5-6. 

c. Note the JSP name (highlighted in bold text in Example 5-14). 

Example 5-14 Global forward for the mOrderltemDisplay view 
<forward 

cl assName="com. i bm. commerce. struts . ECActi onForward" 
name="mOrderItemDi spl ay/10051" 

path="/mobile/ShoppingArea/ShopcartSection/OrderItemDi splay. jsp"> 

</forward> 

6. Repeat steps 1 through 5 for the remaining view names listed in Table 5-6. 

7. Close the struts-config-ext.xml editor by selecting File 0 Close. 

Your completed a table should be similar to that shown in Table 5-7. 


Table 5-7 Mapping from view name to JSP for pages that need modification 


View Name 

JSP Location 

mOrderltemDisplay 

/mobile/ShoppingArea/ShopcartSection/OrderltemDisplay.jsp 

mOrderBillingAddressSelection 

/mobile/ShoppingArea/CheckoutSection/OrderBillingAddressSelection.jsp 

mOrderBillingDetails 

/mobile/ShoppingArea/CheckoutSection/OrderBillingDetails.jsp 

mOrderPaymentDetails 

/mobile/ShoppingArea/CheckoutSection/OrderPaymentDetails.jsp 

mOrderShippingBillingSummaryView 

/mobile/ShoppingArea/OrderSection/OrderSummaryDisplay.jsp 

mOrderShippingBillingConfirmationView 

/mobile/ShoppingArea/OrderSection/OrderConfirmationDisplay.jsp 
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5.4.4 Design new shopping flow 

The analysis in 5.4.3, “Analyze the existing Madisons Mobile Starter Store code” 
on page 228 shows how control is passed between the pages where we need to 
inject new pages. 

Our analysis also shows that the current mobile checkout pages pass information 
in the request parameters between pages until the payment information page is 
shown. Then, the OrderChangeServicePIAdd struts action is called. This action is 
mapped to the addPaymentlnstruction service in the Order component service 
module. The addPaymentlnstruction service allows a client to add payment 
information, including the billing address. 

We will implement our extra pages in a similar manner, passing information about 
the selected shipping address to the shipping method page, which will then 
invoke the OrderChangeServiceShipInfoUpdate struts action. This action is 
mapped to the updateOrderShippinglnfo service. This service allows update of 
the shipping address, shipping method, and requested shipping date. 

Because the OrderChangeServi ceShi plnfollpdate struts action allows the update 
of the shipping address, we use this service to update the shipping address and 
to modify the payment details so that the JSP is not set to a specific shipping 
address if the shipping mode is not pick up in store. 

There is, however, a twist in that the shipping instruction page is shown only if the 
check box on the shipping method page for adding shipping instructions is select. 
We handle this action with JavaScript on the shipping method page by changing 
the URL parameter to the OrderChangeServi ceShi plnfollpdate depending on the 
status of the shipping instruction check box and by updating the shipping 
instruction on the shipping instruction page. The disadvantage of this approach is 
that we invoke the service twice for shoppers that specify shipping instructions. 
The advantage is a slightly simpler flow. 
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Figure 5-29 illustrates the flow of data for the new checkout pages and how they 
fit into the existing flow. 



As the flow chart in Figure 5-29 illustrates, there are several places where the 
flow of control is determined by the shopper’s selections. The recommended 
approach is to use controller commands to redirect the shopper to the correct 
page. In our example, for the sake of simplicity, we use JavaScript within the 
pages to control the flow. 

As you might have noticed in the analysis in “Analyze the current checkout 
pages” on page 229, we did not modify the Store List and Billing Address Select 
pages. 
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5.4.5 Create new pages 


After analyzing the existing pages in 5.4.3, “Analyze the existing Madisons 
Mobile Starter Store code” on page 228 and designing the solution in 5.4.4, 
“Design new shopping flow” on page 239, we are now ready to start 
implementing the modifications. 

We start by creating and testing the new shipping pages. To summarize, we 
create the four pages outlined in Table 5-8. 


Table 5-8 New pages created for selecting and editing shipping addresses 


New View Name 

New JSP Location 

mOrderShippingAddressSelection 

/mobile/ShoppingArea/CheckoutSection/OrderShippingAddressSelection.jsp 

mOrderShippingDetails 

/mobile/ShoppingArea/CheckoutSection/OrderShippingDetails.jsp 

mOrderShippingMethodSelection 

/mobile/ShoppingArea/CheckoutSection/OrderShippingMethodSelection.jsp 

mOrderShippinglnstructions 

/mobile/ShoppingArea/CheckoutSection/OrderShippinglnstructions.jsp 


To create the new pages, you need to complete the following steps: 

1 . Register new pages in the struts configuration. 

2. Configure access control policies for new pages. 

3. Create the new JSPs. 

The following sections guide you through these steps. 

Register new pages in the struts configuration 

Tip: In this section, we use the Struts editor to add the actions. If you prefer to 
edit the source code of the struts-config-ext.xml , you can skip these steps 
and use the information from Example 5-15 on page 245 and Example 5-16 
on page 246. 


You first create the appropriate action mappings and global forwards in the struts 
configuration for the new pages: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 
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3. In the Enterprise Explorer, expand and right-click Stores 0 WebContent 0 
WEB-INF 0 struts-config-ext.xml. 

4. This time, we use the struts configuration file editor to edit the file. From the 
context menu, select Open With 0 Other. 

5. The Editor Selection window opens. Select Struts Configuration File Editor, 
and click OK. 

6. The struts-config-ext.xml file opens in a dedicated editor. 

7. For each of the new views listed in Table 5-8 on page 241 , create an action 
mapping and a global forward: 

a. If you are not already on the Action Mappings tab, click Action Mappings 
from the bottom of the editor window. 

b. In the Action Mappings area of the window, click Add. 

c. A new entry with the name of /actionl should appear at the bottom of the 
list of action mappings, as shown in Figure 5-30. Change the name in-line 
in the list to /mOrderShippingAddressSelection, and press Enter. 



Figure 5-30 New action mapping 

d. Ensure that this action mapping is using the IBM WebSphere Commerce 
action. In the Action Mapping Attributes section, enter the following in the 
Type field, as shown in Figure 5-31: 
com. i bm. commerce .struts . BaseActi on 
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#1 *Struts Configuration File 23 

Action Mappings 




Action Mappings | Local Forwards | Local Exceptions | 



Action Mappings 


Action Mapping attributes 


The following Action Mappings are defined for this 

Attributes of the selected Action Mapping 


conriguracion rue 


©Type: I com.ibm.commerce.struts.BaseAction || Browse... 

1 

@ /mPrivacyPolicy 

(g) /mLanguageCurrencyDisplay 

® /mResetPassword 

/mResetPasswordDisplay 

| Add | 

O Forward: | 


| Remove | 

O Include: | 



Parameter: \_ 


(§} /mMySubscriptionDisplay 


Roles: 


@ /mAdvancedSearchDisplay 


Display Name: | 


@ /mOrderShippingBillingConfirmat. . . 


Description: Q 


@ /mOrderShippingBillingSummary. . . 


□ Default 


(§) /mOrderShippingAddressSelection 


Form Bean Specification 







Figure 5-31 Complete action mapping for mOrderShippingAddressSelection 


e. The actions that you are adding relate to sensitive data, such as customer 
addresses. In addition, you need to ensure that CSRF protection works for 
the checkout flow. So, you need to configure the actions to require HTTPS 
by completing the following steps in the Action Mapping Extensions 
section: 

i. Click Add. 

ii. A new line is displayed in the table. In the Attribute column, select 

property. 

iii. In the Key/Property column, enter https. 

iv. In the Value column, enter 0:1. 

v. Press Ctrl+S to save the changes. 

f. Create the global forward. Switch to the Global Forwards part of the struts 
configuration by clicking the Global Forwards tab at the bottom of the 
editor window. 

g. In the Global Forwards section, click Add to create a new forward. 

h. A new entry with the name of success should appear at the bottom of the 
list of global forwards, as shown in Figure 5-32. Change the name in-line 
in the list to /mOrderShippingAddressSelection, and press Enter. 
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Figure 5-32 New global forward in struts-config-ext.xml 

i. Change the text from success to: 
mOrderShi ppi ngAddressSel ection /storeld 

Where storeld is the store ID of your mobile store. Our Madisons Mobile 
Starter Store had store ID 10051 , so we entered the following storeld in 
our example: 

mOrderShi ppi ngAddressSel ection/10051 

j. In the Path entry fields in Forward Attributes section, enter the name of the 
JSP from Table 5-8 on page 241 . We entered the following name: 

/mobi 1 e/Shoppi ngArea/CheckoutSecti on/OrderShi ppi ngAddress 
Selection. jsp 

k. In the Class entry field under the Forward Mapping Extensions, enter the 
following class name: 

com. ibm. commerce. struts. ECActionForward 

l. The new forward mapping should now look like that shown in Figure 5-33. 
Press Ctrl+S to save your changes. 
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ts Configuration File -€v_ 


Global Forwards 


Global Forwards 

The following Global Forwards are defined for this configuration file 
O mOrderShiDDinaBillinaSummarv View/ 10... ■*■! | Add | 
O mOrderShippingBillingConf irmationVie . . . | — — I 

<>ChangePassword/10051/-U 
<4> ReLogonFormView/ 1 0051/- 1 1 
O RememberMeLogonFormView/ 1005 1/- 1 1 
O AccessControlErrorView/ 1 005 1 /- 1 1 
O GenericAppiicationError/ 1005 1/- 1 1 
O GenericSystemError/ 1 005 1 /- 1 1 
O PreviewExclusionView/10051/-ll 
<4> OrderProcessErrorView/10051/-l 1 
O RLBadPartNumberErrorView/1 005 1 /-1 1 
<4/ RLInvalidlnputErrorView/ 10051/- 11 
O CookieErrorView/10051/-l 1 
O InactiveActivityTokenErrorView/10051 , , . 


Forward Attributes 

Attributes of the selected Forward 
Path: |/mobile/5hoppingArea/Checkout5ection/Order5 

□ Redirect 

□ Context Relative 

Display Name: | ~ 

Description: | ~ 

Forward Mapping Extensions 
Mapping Extension of the selected Forward 
Attribute Key/Property Value 


Figure 5-33 The new completed global forward 


8. Repeat steps 1 through 7 for the remaining rows in Table 5-8 on page 241 . At 
the end, the source of the struts-config-ext.xml file should contain the 
action mappings shown in Example 5-15. You can verify this information by 
clicking the Source tab at the bottom of the editor. 

Example 5-15 Action mappings for the new pages 
<action 

path="/mOrderShippingAddressSelection" 
type="com.ibm. commerce. struts. BaseAction"> 

<set-property property="https" val ue="0: l"/> 

</action> 

<action 

path="/m0rderShi ppi ngDetai Is" 
type="com.ibm. commerce. struts. BaseAction"> 

<set-property property="https" val ue="0: l"/> 

</action> 

<action 

path="/mOrderShippingMethodSelection" 
type="com.ibm. commerce. struts. BaseAction"> 

<set-property property="https" val ue="0: l"/> 

</action> 

<action 
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path="/mOrderShipping Instruct ions" 
type="com.ibm.commerce.struts.BaseAction"> 
<set-property property="https" val ue="0: l"/> 
</action> 


Furthermore, the struts-config-ext.xml should now contain the global 
forwards shown in Example 5-16. 

Example 5-16 Global forwards for the new pages 
<forward name="mOrderShippingAddressSelect ion/ 10051" 

path="/mobi 1 e/Shoppi ngArea/CheckoutSecti on/OrderShi ppi ngAddressSel ecti on . j sp" 
cl assName="com. i bm. commerce. struts . ECActi onForward"> 

</forward> 

<forward name="mOrderShi ppi ngDetai 1 s/10051" 

path="/mobi 1 e/Shoppi ngArea/CheckoutSecti on/OrderShi ppi ngDetai 1 s . jsp" 
cl assName="com. i bm. commerce. struts . ECActi onForward"> 

</forward> 

<forward name="mOrderShi ppi ngMethodSel ecti on/10051" 

path="/mobi 1 e/Shoppi ngArea/CheckoutSecti on/OrderShi ppi ngMethodSel ecti on .jsp" 
cl assName="com. i bm. commerce. struts . ECActi onForward"> 

</forward> 

<forward name= "mOrderShi ppi ng Instruct ions/ 10051" 

path="/mobi 1 e/Shoppi ngArea/CheckoutSecti on/OrderShi ppi nglnstructi ons . jsp" 
cl assName="com. i bm. commerce. struts . ECActi onForward"> 

</forward> 


9. Close the struts-config-ext.xml editor by selecting File 0 Close. 

Configure access control policies for new pages 

Next, you need to set up the appropriate access control policies before any 
shopper can access the new pages that you created. IBM WebSphere 
Commerce uses an explicit access control model in which resources only are 
accessible to a given group of users if they have been specifically set up to be 
accessible to that group. 1 

The four new pages listed in Table 5-8 on page 241 need the same level of 
access control as the remaining mobile checkout pages. So, you need to analyze 
the existing access control policies for one of those pages and model the new 
pages from that analysis. 


1 The exception to this rule is the access control policy called SiteAdmMstratorCanDoEverything. This 
policy allows users with the role of Site Administrator to perform any type of action on any resource, 
regardless of other policies in place for that resource. 
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Analyze access control policies for mOrderBillingAddressSelection 

We used the IBM WebSphere Commerce Organization Administration Console 
to browse the existing access control policies for the billing address selection 
page. This page has the view name mOrderBillingAddressSelection. To browse 
the access control policies for mOrderBillingAddressSelection: 

1 . Open the Organization Administration Console in Microsoft Internet Explorer 
by visiting the following URL: 

https: //local host:8004/webapp/wcs/orgadmin/servlet/Tool sLogon?XMLFi 1 
e=buyerconsol e . BuyAdmi nConsol eLogon 

2. Enter the user name and password of the site administration user. We 
entered the following information: 

Username: wcsadmin 

Password: wcsadmin 

Tip: The default user name and password for the site administration user 
within the toolkit is wcsadmi n/wcsadmi n. The first time that you log on using 
these credentials, you are asked to change the password. After you 
change the password, click Change to continue. Be sure to remember the 
new password, because you will need it for future steps. 

3. In the Organization Administration Console welcome window, select Access 
Management 0 Action Groups. A complete list of action groups opens. 

You cannot search for an action group using a specific action name in the 
Organization Administration Console. So, you have to make an educated 
guess on the selection of an action group name and then check to see 
whether the action is included in that action group. 

Note: Note that the list of action groups is in alphabetical order. 

First look for a specific Madisons Starter Store or Madisons Mobile Starter 
Store action group. Click Next until you get find an action group that starts 
with Madisons. In our example, the first action group that started Madisons 
with was on page eight of the list. 

4. Select MadisonsAIIUsersViews, and click Show Actions. The list of actions 
in the MadisonsAIIUsersViews action group is displayed. In our example, we 
found 1 1 pages of actions. Scroll through the list one page at a time by 
clicking Next, and look for mOrderBillingAddressSelection. 

In our scenario, we did not find mOrderBillingAddressSelection, so we had to 
look in another action group. 
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5. Go back to the list of action groups by selecting Access Management 0 
Action Groups. The complete list of action groups is displayed again. 

Because we did not find the action we need in the Madisons-specific action 
group, we try the general action group for all site views called 
AllSiteUsersViews. 

6. Select AllSiteUsersViews, and click Show Actions. 

Tip: The AllSiteUsersViews action group should be on the first page. If you 
do not see it on this page, scroll to the next page until you find this action 
group. 

7. The list of actions in the AllSiteUsersViews action group is displayed. In our 
example, we found 12 pages of actions. Scroll through the list one page at a 
time by clicking Next, and look for mOrderBillingAddressSelection. 

In our example, we found mOrderBillingAddressSelection on page 1 1 , along 
with the remaining mobile views, which tells us that the mobile views are in 
the action group AllSiteUsersViews. 


Note: Although the list of actions is sorted alphabetically, the sorting order 
is the standard ASCII order, which places all the lowercase letters after the 
uppercase letters. Thus, the actions that begin with a lowercase m show at 
the end of the list, not with the actions that begin with an uppercase M. 


Now that you have identified the action group, you need to determine the 
organization that owns this action group. You will need this information to load the 
new actions into the action group. You can obtain this information using one of 
the following methods: 

► Search for the definition in the XML files in ttC_Home\xm\ \pol i ci es\xml . 

► Look up the organization name in the database into which you load the 
policies. 

In our scenario, we use the first option; however, for completeness, 

Example 5-17 provides sample SQL that you can use to determine the 
organization name and ID for a the AllSiteUsersViews action group. 

Example 5- 1 7 SQL for determining the organization name and ID for an action group 

SELECT GROUPNAME, ORGENTITYNAME, ORGENTITYJD 

FROM ACACTGRP, ORGENTITY 

WHERE GROUPNAME = 'AllSiteUsersViews' 

AND ACACTGRP. MEMBERJD = ORGENTITY. ORGENTITYJD 
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To determine the owning organization for a standard IBM WebSphere Commerce 
action group through the standard policy XML files: 

1 . Open the following file in your favorite text editor. 

WC_Wome\x ml \pol i ci es\xml \defaul tAccessControl Pol i ci es . xml 
We opened Notepad by selecting Start 0 Programs 0 Accessories 0 
Notepad. 

2. Search for the following text: 

<ActionGroup Name="Al ISiteUsersViews" 

We used Ctrl+F to use the search function in Notepad 

3. The snippet shown in Example 5-18 is displayed. The highlighted line marks 
the searched for text. 

Example 5-18 Snippet from defaultAccessControlPolicies.xml showing the action group 

<ActionGroup Name="UserRoleAssign" OwnerID="RootOrganization" > 
<ActionGroupAction Name=" com. ibm. commerce. usermanagement. commands. Mem 
berRoleAssignCmd-User"/> 

<ActionGroupAction Name=" com. ibm. commerce. usermanagement. commands. Mem 
berRoleUnassignCmd-User"/> 

</ActionGroup> 

<!-- Group all site views together into one action group --> 
<ActionGroup Name="Al ISiteUsersViews" OwnerID="RootOrganization"> 

<Acti onGroupActi on Name="Admi nConHome"/> 

<Acti onGroupActi on Name="Admi nConLaunched"/> 

<Acti onGroupActi on Name="Admi nConSi teStoreSel ecti on"/> 

<Acti onGroupActi on Name="ButtonVi ew"/> 

Example 5-18 shows that AllSiteUsersViews is owned by Root Organization. You 
can copy the <ActionGroup> line from this file and use it in the access control 
policy file as described in the next section. 

Create access control policies for the new views 

Because mOrderBillingAddressSelection is located in the action group 
AllSiteUsersViews, you must also place the four new views as actions in this 
action group to allow any user in the site to access the new views. To create 
access control policies for the new views: 

1 . Open your favorite text editor. We opened Notepad by selecting Start 0 
Programs 0 Accessories 0 Notepad. 

2. Enter the XML document shown in Example 5-1 9 into the text editor. 
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The XML in Example 5-19 should be straightforward to read. Basically, it 
defines the four new actions using <Action> XML nodes and then associates 
these actions to the AllSiteUsersViews action group. You can determine the 
reference to RootOrganization in the <ActionGroup> node from the bootstrap 
default access control file: 

WC_Home/x ml /pol i ci es/xml /defaul tAccessControl Pol i ci es . xml 
Another approach is to check the contents of the ACPOLICY table in the IBM 
WebSphere Commerce instance database. 

We obtained the value from the bootstrap default access control policy file. 
Example 5-19 Access control policies for the custom views 
<?xml version="1.0" encoding="IS0-8859-l" standal one="no" ?> 

< ! DOCTYPE Policies SYSTEM " . ./dtd/accesscontrol pol i cies.dtd"> 

<Pol icies> 

<!-- BEGIN: Define the actions --> 

<Action Name="mOrderShi ppi ngAddressSel ecti on" 

CommandName="mOrderShippingAddressSelection" /> 

<Act i on Name= "mOrderShi ppi ngDetai 1 s " 

CommandName="mOrderShi ppi ngDetai Is" /> 

<Action Name= "mOrderShi ppi ngMethodSel ecti on" 

CornmandName="mOrderShippingMethodSelection" /> 

<Action Name= "mOrderShi ppi nglnstruct ions" 

CommandName="mOrderShippingInstructions" /> 

<!-- END: Define the actions --> 

<!-- Map the actions to the AllSiteUsersViews action group --> 
<ActionGroup Name="Al ISiteUsersViews" OwnerID="RootOrganization"> 
<Acti onGroupActi on Name="mOrderShi ppi ngAddressSel ecti on"/> 

<Acti onGroupActi on Name="mOrderShi ppi ngDetai 1 s"/> 

<Acti onGroupActi on Name="mOrderShi ppi ngMethodSel ecti on"/> 

<Acti onGroupActi on Name= "mOrderShi ppi nglnstructi ons "/> 
</ActionGroup> 

</Pol i ci es> 
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3. Save the file as (7C_Wome\x ml \pol i ci es\xml \mobi 1 e-shi ppi ng-acp. xml . In our 
example, we saved the file as: 

C:\IBM\WCDE_ENT70\xml \pol i cies\xml \mobil e-shi ppi ng-acp. xml 

4. Close the text editor. 


Load the access control policies for the new views 

Because you have now created the access control policy file and placed it in the 
location to be picked up by IBM WebSphere Commerce, you can load these new 
views into the development database. 


Important: The default database provider for IBM WebSphere Commerce V7 
Developer Edition is IBM Cloudscape. IBM Cloudscape allows only one 
connection to the database at a time. As such, it is not possible to load the 
access control policies while the server is running. 

If you use IBM Cloudscape for the database, you need to stop the server while 
the access control policies are loaded and then restart the server afterwards. 


To load the custom access control policies: 

1 . Open a command line window by selecting Start 0 Programs 0 
Accessories 0 Command Prompt. 

2. Change to the WC_Home \ bi n directory, where k/C_Home is the installation 
directory of IBM WebSphere Commerce V7 Developer Edition. For example, 
we entered the following command: 

cd \IBM\WCDE_ENT70\bin 

3. Run the following command to transform the XML and load the new policies: 
acpload mobil e-shi ppi ng-acp. xml 

Note: If you are not using IBM Cloudscape as the database manager, you 
need to specify connection parameters on the acpload command line. Run 
acpload without any parameters to learn the syntax of the command. 

4. The acpload command runs for a while. Example 5-20 shows the expected 
output. 

Example 5-20 Expected output from acpload 

C:\IBM\WCDE_ENT70\bi n>acpl oad mobi 1 e-shi ppi ng-acp. xml 
Running XMLTransform. . . 

Running Id Resolver. . . 

Running MassLoader. . . 
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Examine acpload.log to ensure that everything completed 
successful ly. 


C:\IBM\WCDE_ENT70\bi n> 


5. Because the output from acpload might not notify you of errors, you need to 
inspect the acpl oad . 1 og file for errors, as stated in the console output from 

acpload. 

The acpl oad . 1 og file is located in the WC_Home\ 1 ogs directory. In our example, 
the file was located in the following directory: 

C:\IBM\WCDE_ENT70\logs 

Example 5-21 shows a sample of the output in the acpl oad . 1 og file. 

Example 5-2 1 Output in acpload.log from a successful load 
Running XMLTransform. . . 

Running Id Resolver. . . 

Running MassLoader. . . 


If you are using IBM Cloudscape and have not stopped the server, the 
acpl oad . 1 og log will contain an error similar to the one shown in 
Example 5-22. If you receive this error, stop the application that is using the 
database (most likely the test server), and retry step 3 on page 251 . 

Example 5-22 Error message from acpload if the IBM Cloudscape database is in use 

Running XMLTransform... 

Running Id Resolver. . . 

Running MassLoader... 

Failed to start database 'C:\IBM\WCDE_E~l\db\maH 1 , see the next 
exception for details. 


Another method to verify that the load process has completed successfully is 
to examine the transformed and ID resolved XML files. These files are located 
in the same directory as the mobi 1 e-shi pping-acp. xml file, the 
UC_Home\xm] \pol i ci es\xml directory. 
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In our example, the C:\IBM\WCDE_ENT70 directory included the following files: 
- mobi 1 e-shi ppi ng-acp_xml trans . xml 

In our example, this file had the content shown in Example 5-23 
(reformatted here for readability). When checking for errors, it is important 
to verify the following information: 

• All attributes must have values. For example, no attributes are specified 
with empty strings as the value. 

• All actions must have corresponding <acacti on> and <acactactgp> 
nodes in the XML document. 

• There must be one <acactgrp> node that corresponds to the 
<ActionGroup> node shown in Example 5-19 on page 250. 

Example 5-23 The transformed access control policy file 
<?xml version="1.0" encodi ng="UTF-8"?><! DOCTYPE import SYSTEM 
./schema/xml /wcs .dtd"><import> 

<acaction ACACTION_ID="@mOrderShi ppi ngAddressSel ecti on" 
ACTION="mOrderShi ppi ngAddressSel ecti on"/> 

<acaction ACACTION_ID="@mOrderShi ppi ngDetai Is" 

ACTION="mOrderShi ppi ngDetai 1 s"/> 

<acaction ACACTION_ID="@mOrderShi ppi ngMethodSel ecti on" 
ACTION="mOrderShi ppi ngMethodSel ecti on"/> 

<acaction ACACTION_ID="@mOrderShippingInstructions" 
ACTION="mOrderShippingInstructions"/> 

<acactgrp ACACTGRP_ID="@A1 ISiteUsersViews" 

GR0UPNAME="A1 1 Si tellsersViews" 

MEMBER_ID="-2001"/> 

<acactactgp ACACTGRP_ID="@A1 1 Si teUsersVi ews " 

ACACTION_ID="@mOrderShi ppi ngAddressSel ecti on"/> 

<acactactgp ACACTGRP_ID="@A1 1 Si teUsersVi ews " 
ACACTION_ID="@mOrderShi ppi ngDetai 1 s"/> 

<acactactgp ACACTGRP_ID="@A1 1 Si teUsersVi ews " 

ACACTION_ID="@mOrderShi ppi ngMethodSel ecti on"/> 

<acactactgp ACACTGRP_ID="@A1 1 Si teUsersVi ews " 

ACACTION_ID="@mOrderShippingInstructions"/> 

</import> 


Chapter 5. Mobile commerce features in WebSphere Commerce V7 253 



- mobil e-shi pping-acp_idres. xml 

In our example, this file had the content shown in Example 5-24 
(reformatted and abbreviated here for readability). When checking for 
errors, it is important to note the following information: 

• A very long DTD preamble, which defines XML nodes for all standard 
IBM WebSphere Commerce V7 tables, must be present. 

• All the XML nodes from the mobi 1 e-shi pping-acp_xmltrans. xml file 
must be present, although with different attributes. 

• Apart from the ACTION attributes of the <acacti on> nodes, all 
attributes must have numeric values. 

Example 5-24 The ID resolved access control policy file 

<?xml version=" 1 .0"encodi ng="UTF-8"?> 

<!-- Name: 

C : \IBM\WCDE_E~l\xml \pol i ci es\xml \mobi 1 e-shi ppi ng-acp_i dres . xml 
Description: This file contain data generated by IBM utility. 


< ! DOCTYPE import [ 

<! ELEMENT import ( (acacgpdesc | acactactgp | acactdesc | acactgrp | acacti on 
| acattr | acattrdesc | acccmdgrp | acccmdtype | acccustexc | accl ogmai n | accl og 
sub|ac 

...many lines of DTD declarations removed... 

<! ELEMENT wusrtrvw EMPTY> 

<! ATTLIST wusrtrvw 

STOREENTJD CDATA fREQUIRED 
TOTALVISITS CDATA fREQUIRED 
TOTALSESSIONS CDATA fREQUIRED 
DISTINCTUSERS CDATA fREQUIRED 


<import> 

<acaction 

ACACTI0N_ID="13151" 

ACTION="mOrderShippingAddressSelection" 

/> 

<acaction 

ACACTION_ID=" 13152" 
ACTION="mOrderShippingDetai Is" 
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<acaction 

ACACTION_ID=" 13153" 

ACTION="mOrderShippingMethodSelection" 

/> 

<acaction 

ACACTION_ID=" 13154" 
ACTION="mOrderShippingInstructions" 

/> 

<acactactgp 

ACACTGRP_ID=" 10196" 

ACACTI0N_ID="13151" 

/> 

<acactactgp 

ACACTGRP_ID=" 10196" 

ACACTI0N_ID=" 13152" 

/> 

<acactactgp 

ACACTGRP_ID=" 10196" 

ACACTI0N_ID=" 13153" 

/> 

<acactactgp 

ACACTGRP_ID=" 10196" 

ACACTI0N_ID=" 13154" 

/> 

</import> 


Create the new JSPs 

Now that you have loaded the access control policies for the new views, you can 
create the JSPs that render these views. As listed in Table 5-8 on page 241 , you 
need to create the following JSPs: 

► OrderShippingAddressSelection. jsp 

► OrderShippingDetails.jsp 

► OrderShi ppi ngMethodSel ecti on . j sp 

► OrderShippinglnstructions.jsp 

All of these pages will reside within the mobile checkout directory for the 
Madisons Mobile Starter Store, which in IBM WebSphere Commerce V 7 
Developer Edition is the following directory: 

WC_Wome\workspace\Stores\WebContent\Madi sons\mobi 1 e\Shoppi ngArea\ 
CheckoutSection 
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Create the OrderShippingAddressSelection.jsp file 

You create a new OrderShippingAddressSelection.jsp that displays all the 
current shipping addresses, which allows the shopper to select an address to 
which to ship the merchandise. An alternative method to simplify changes to both 
pages is to create a generic address selection JSP and then pass that JSP to the 
address type as a parameter. However, we chose to introduce another JSP to 
minimize the number of edited starter store pages in this example. 

To create the shipping address selection JSP: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 

3. In the Enterprise Explorer, expand and right-click Stores 0 WebContent 0 
Madisons 0 mobile 0 ShoppingArea 0 CheckoutSection. 

4. In the context menu that opens, select New 0 File. 

5. The New File dialog box opens. Enter OrderShippingAddressSelection.jsp 
in the File name field, and click Finish. 

6. The JSP file editor opens in the source tab and shows a blank page. Enter the 
skeleton JSP file shown in Example 5-25 into the page, and press Ctrl+S to 
save the file. Do not close the file yet. 

The code in Example 5-25 provides the skeleton in which you can add the 
code for the page. Run by itself, this example code produces only the header 
and footer for the page. You can insert the remaining content at the JSP 
comment place-holders. 

Example 5-25 Skeleton code for OrderShippingAddressSelection.jsp 


***** 

* This JSP displays all existing shipping addresses, and allows the user to 

* select the address for checkout 
***** 


<!-- BEGIN OrderShippingAddressSelection.jsp --> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/fmt" prefix="fmt" %> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/functions" prefix="fn" %> 
<%@ taglib uri="http://java. sun.com/jsp/jstl/core" prefix="c" %> 

<%@ taglib uri="http://commerce. ibm.com/base" prefix="wcbase" %> 

<%@ taglib uri="http://commerce. ibm.com/foundation" prefix="wcf" %> 
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<%@ include fi 1 e=" ./incl ude/parameters. jspf" %> 

<%@ include file=" . ./. ./include/JSTLEnvironmentSetup.jspf" %> 

<%-- 1. Initialization --%> 

<! DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" 

"http://www.w3.org/TR/xhtml -basic/xhtml -basi ell .dtd"> 

<html xml ns=" http: //www. w3.org/ 1999/xhtml " 1 ang="${shortLocal e} " 
xml :lang="${shortLocale}"> 

<head> 

<title> 

<fmt:message key="SHIPPING_ADDRESS_SELECT_TITLE" bundl e="${storeText} "/> 
- <c:out value="${storeName}"/> 

</title> 

<meta http-equi v="content-type" content="appl i cati on/xhtml +xml " /> 

<meta http-equi v="cache-control " content="max-age=300" /> 

<meta name="viewport" 

content="width=device-width, initial-scale=1.0, user-seal abl e=no" /> 
<1 i nk rel="stylesheet" type="text/css" href="${cssPath} " /> 

<%-- 4. Javascript validation — %> 

</head> 

<body> 

<div id="wrapper"> 

<%@ include fi 1 e=" . ./. ./i ncl ude/HeaderDi spl ay. jspf" %> 

<%@ include fi 1 e=" . ./. ./i ncl ude/BreadCrumbTrai 1 Di spl ay . jspf " %> 

<div id="address_l ist" cl ass="content_box"> 

<%-- 2. Main content --%> 

</di v> 

<%@ include fi 1 e=" . ./. ./i ncl ude/FooterDi spl ay. jspf" %> 

</ di v> 

</body> 

</html> 

<!-- END OrderShippingAddressSelection.jsp --> 


7. In the JSP file, locate the following line: 

<%-- 1. Initialization — %> 

Add the code shown in Example 5-26 after this line. This code executes the 
following actions: 

- Initializes some variables used in the breadcrumb JSP fragment for 
rendering the correct breadcrumb path. 

- Sets up URLs used in the main content for transitioning to the next page or 
removing an address. 
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- Invokes the f i ndCurrentShoppi ngCart and f i ndCurrentPerson services to 
retrieve data that is needed in rendering the page. 

- Determines the number and nature of addresses for the current user by 
inspecting the address in the shopper’s address book. 


Important: Technically, this list of addresses can contain addresses 
that are not valid as shipping addresses. IBM WebSphere Commerce 
operates with the following address types, as defined by the 
ADDRESSTYPE column of the ADDRESS table: 

► Billing-only address (ADDRESSTYPE=’B’) 

► Shipping-only address (ADDRESSTYPE=’S’) 

► General address (ADDRESSTYPE=’SB’ used as both the billing and 
shipping address) 

By default, IBM WebSphere Commerce creates a general address. We 
use this type of address and assume that all addresses are valid as 
shipping addresses. A more complete implementation can filter out the 
billing-only addresses from the list. 


Example 5-26 Initialization code for OrderShippingAddressSelection.jsp 

<%-- Required variables for breadcrumb support --%> 

<c:set var="shoppingcartPageGroup" value="true" scope="request"/> 

<c:set var="shippingSelectionPage" value="true" scope="request"/> 

<%-- URL for next page --%> 

<wcf :url var="OrderShi ppi ngDetai 1 sURL" val ue="mOrderShi ppi ngDetai 1 s"> 
<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

<wcf:param name="orderId" val ue="${WCParam.orderId} " /> 

</wcf :url> 

<%-- URL for removing an address --%> 

<wcf :url var="AddressDeleteURL" val ue="PersonChangeServiceAddressDelete"> 
<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

<wcf:param name="URL" value="mOrderShippingAddressSelection" /> 

</wcf :url> 

<%-- Retrieve details about the current order 

(mainly to get the current shipping address) --%> 

<wcf :getData type= " com. ibm. commerce. order. facade. datatypes. OrderType" 
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var= "order" expressionBui lder="findCurrentShoppingCart" scope="request"> 
<wcf:param name="accessProfi 1 e" val ue="IBM_Detai 1 s" /> 

</wcf :getData> 

<%-- Retrieve data for the current user - we do this to get the address book 
and the self address --%> 

<wcf :getData type="com. i bm. commerce. member . facade. datatypes . PersonType" 
var= "person" expressionBui lder="findCurrentPerson"> 

<wcf:param name="accessProfi 1 e" val ue="IBM_Al 1 " /> 

</wcf :getData> 

<%-- get the current shipping address ID --%> 

<c:set var="shipInfo" val ue="${order.orderltem[0] .orderltemShippinglnfo} " /> 
<c:set var="currentShip" 

val ue= "$ { shi pi nfo.shippingAddress. contact I nfoldentifier. uni quel D}" /> 

<%-- determine which addresses the current shopper has --%> 

<c:set var="hasVal idAddresses" val ue="fal se"/> 

<c:set var="hasSel fAddress" val ue="${ lempty person. contactlnfo} " /> 

<c:set var="addressBook" value="${person.addressBook. contact}" /> 

<c:set var="numAddresses" value="${fn:length(addressBook)}" /> 

<c:if test="${ (numAddresses > 0 || hasSel fAddress) && ! hasVal idAddresses} "> 
<c:set var="hasVal idAddresses" val ue="true"/> 

</c:if> 


8. In the JSP file, locate the following line: 

<%-- 2. Main content --%> 

Add the code shown in Example 5-27 after this line. This code executes the 
following actions: 

- Displays the page title. 

- Loops through the shopper’s addresses (with one extra loop iteration if the 
shopper has a self address) and completes the following steps: 

• Determines whether the current iteration displays the self address 
(handled in a special first iteration). 

• Determines whether the current address corresponds to the currently 
selected shipping address for the order. 

• Displays the address. (The code is added in a later step.) 

- Adds a link to create a new address (redirect to mOrderShippingDetails). 

- Adds a button to submit the selected shipping address to 
mOrderShippingMethodSelection. The submission is done through the 
Java Script function checkAddress, which is added in the next step. 
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Example 5-27 Main content for OrderShippingAddressSelection.jsp 

<div class="heading_container_with_underl ine"> 

<h2><fmt:message key="YOUR_SHIPPING_ADDRESSES" bundl e="${storeText} " /></h2> 

<di v cl ass="cl ear_f 1 oat"></di v> 

</di v> 

<p class="paragraph_blurb"> 

<fmt:message key="SHIPPING_ADDRESS_SELECT" bundl e="${storeText} " /> 

</p> 

<c:choose> 

<c:when test="${hasVal idAddresses} "> 

<form name="shi ppi ngAddressForm"> 

<%— The address book will not contain the self address, so we'll need to 
jump through a few hoops to include this in the loop... --%> 

<%— first determine if there is a self address to include --%> 
<c:choose> 

<c:when test="${hasSel f Address } "> 

<c:set var="beginlndex" value="0" /> 

</c:when> 

<c:otherwise> 

<c:set var="beginlndex" value="l" /> 

</c:otherwise> 

</c:choose> 

<%-- then go through all addresses (including the self address) --%> 
<c:forEach var="index" begi n="${begi nlndex} " end="${numAddresses} "> 

<%— determine if this is the self address or a regular entry --%> 
<c:choose> 

<c:when test="${index == 0}"> 

<c:set var="contact" val ue="${person.contactInfo} " /> 

</c:when> 

<c:otherwise> 

<c:set var="contact" val ue="${addressBook[i ndex-1] } " /> 
</c:otherwise> 

</c:choose> 

<c:set var="contactId" value="${contact.contactInfoIdentifier}" /> 
<c:set var="addressld" val ue="${contactId.uniqueID} " /> 

<c:choose> 

<c:when test="${currentShip == addressld}"> 

<c:set var="optionChecked" value="checked='checked'"/> 

</c:when> 

<c:otherwise> 

<c:set var="optionChecked" value=""/> 

</c:otherwise> 

</c:choose> 
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<ul class="entry"> 

<%-- 3. Address Display --%> 

</ul> 

</c:forEach> 

</form> 

</c:when> 

<c:otherwise> 

<%-- There are no addresses found. 

Redirect to the address details page to create an address. --%> 
<script type="text/javascript"> 

wi ndow. 1 ocati on . href = 1 <c : out val ue="$ {OrderShi ppi ngDetai 1 sURL} " /> 1 ; 
</script> 

</c:otherwise> 

</c:choose> 

<di v> 

<fmt:message key="SHIPPING_ADDRESS_CREATE" bundl e="${storeText} " /> 

<p class="paragraph_blurb"> 

<span class="bullet">&#187; </span> 

<a href= "$ {OrderShi ppi ngDetai 1 sURL} " 

title="<fmt:message key="CREATE_NEW_ADDRESS" 
bundl e="${storeText} " />"> 

<fmt:message key="CREATE_NEW_ADDRESS" bundl e="${storeText} " /> 

</a> 

</p> 

</di v> 

<form i d="your_store_l i st_buttons"> 

<input type="button" id="conti nue_checkout" name="conti nue_checkout" 

val ue="<fmt:message key="CONTINUE_CHECKOUT" bundl e="${storeText} " />" 
class="input_button_float" oncl i ck="checkAddress () ; " /> 

</form> 

<form id=" conti nue_checkout_form" acti on="mOrderShi ppi ngMethodSel ecti on"> 
<input type="hidden" name="langld" val ue="${ 1 angld} " /> 

<input type="hidden" name="storeId" value="${WCParam.storeId}" /> 

<input type="hidden" name="catal ogld" value="${WCParam.catalogId}" /> 
<input type="hidden" name="addressld" value="" id="shippingAddressId" /> 
</form> 
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9. In the JSP file, locate the following line: 

<%— 3. Address Display --%> 

Add the code shown in Example 5-28 after this line. This code executes the 
following actions: 

- Determines the language-specific name for the country listed in the 
address. 

- Determines the language-specific name for the state or province listed in 
the address. 

- Displays the various parts of the address. 

- Displays links to edit and delete the address. (Deletes the address only if 
the address is not a self-address.) 

Example 5-28 Code to display one shipping address for OrderShippingAddressSelection.jsp 

<c : set var="countryDi spl ayName" val ue="$ { contact . address . country} "/> 

<c : set var="stateDi spl ayName" val ue="$ {contact . address . stateOrProvi nceName} "/> 
<wcbase:useBean id="countryBean" 

cl assname= "com. ibm. commerce. user. beans. CountryStateLi stDataBean"> 

<c:set target="${countryBean} " property="countryCode" 
val ue="$ {contact. address. country }"/> 

</wcbase:useBean> 

<c:forEach var="country" items="${countryBean.countries}"> 

<c:if test="${ iempty country. code && country. code == contact. address. country}"> 
<c:set var="countryDispl ayName" val ue= "${ country .di spl ayName} "/> 

</ c : i f > 

<c:if test="${ iempty country. states} "> 

<c:forEach var="state" items="${country. states} " varStatus="counter"> 

<c:if test="${ iempty state. code && 

state. code == contact. address. stateOrProvi nceName} "> 

<c:set var="stateDispl ayName" val ue="${ state. di spl ayName} "/> 

</ c : i f > 

</c:forEach> 

</c : i f > 

</c:forEach> 

<1 i> 

<div class="radio_container"> 

<input type=" radio" id="shipping_address_selection_${ address Id} " 
name="shipping_address_selection" 

val ue="<c:out val ue="${addressld} "/>" ${optionChecked} /> 

<1 abel for="shipping_address_selection_${ address Id} "> 

<span class="bold"> 

${ contact Id. external Identi tier. contact InfoNickName} 
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</span> 

</label> 

</di v> 

</li> 

<li class="al ign_with_radio"> 

<c : out val ue="$ {contact . contactName . f i rstName} "/> 

<c : out val ue="$ {contact . contactName . 1 astName} "/> 

</li> 

<li class="al ign_with_radio"> 

<c:out val ue="$ {contact. address. addressLi ne[0] } "/> 

<c:out val ue="$ {contact. address. addressLi ne[l] } "/> 

</li> 

<li class="al ign_with_radio"> 

<c:out val ue="${contact. address. city}"/> <c:out value="${stateDisplayName}"/> 
</li> 

<li class="al ign_with_radio"> 

<c:out val ue="${countryDisplayName} "/> 

<c:out val ue="${ contact. address. postal Code} "/> 

</li> 

<1 i class="al ign_with_radio"><c:out val ue="${ contact. tel ephonel. value} "/></li> 

<1 i class="al ign_with_radio"><c:out val ue="${ contact. emai 1 Address 1. val ue} "/></l i > 
<li class="al ign_with_radio"> 

<span class="bullet">&#187; </span> 

<a href="${OrderShi ppingDetai 1 sURL} &addressld=$ {address Id } "> 

<fmt:message key="MO_EDIT" bundl e="${storeText} "/> 

</a> 

</li> 

<c:if test="${person.contactInfo.contactInfoIdentifier.uniqueID != addressld}"> 
<li class="al ign_with_radio"> 

<span class="bullet">&#187; </span> 

<a href="${AddressDeleteURL}&addressId=${addressId} "> 

<fmt:message key="MSTLST_REMOVE_STORE" bundl e="${storeText} "/> 

</a> 

</li> 

</c:if> 
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10. In the JSP, locate the following line: 

<%— 4. Javascript validation --%> 

Add the code shown in Example 5-29 after this line. This code submits the 
form only if the shopper has actually selected one of the addresses in the 
form. 

Example 5-29 Form validation for OrderShippingAddressSelection.jsp 

<script type="text/javascript"> 

//<! [CDATA[ 

function checkAddress () { 
var addressld = null; 

if (typeof (document. shippingAddressForm) != "undefined") { 

var addressSelect = document. shippingAddressForm. shi ppi ng_address_sel ection; 
if (typeof (addressSelect. length) != "undefined") { 

// Multiple addresses are available 
for(var i = 0 ; i < addressSelect. length; i++) { 
if (addressSelect[i] .checked) { 

addressld = addressSelect[i] .val ue; 
break; 


else { 

// Only one address is available 
addressld = addressSelect. val ue; 

} 

if(addressld != null) { 

document. getElementById("shippingAddressId") .value = addressld; 
document. get El ementBy Id ("conti nue_checkout_form") .submit() ; 


//]]> 

</script> 


1 1 .Save the file by pressing Ctrl+S. 

The OrderShippingAddressSelection.jsp file is now complete. Later, after you 
test the page, you can define the resource bundles for the page, as described in 
“Add localized texts” on page 284. 
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Create the OrderShippingDetails.jsp file 

Next, you create a new OrderShippingDetai 1 s. jsp file that is used for creating 
and editing shipping addresses. Because the shipping address details page is 
very similar to the existing billing address details, we base the 
OrderShippingDetails.jsp file on the corresponding billing address page. As 
with the shipping address selection JSP, an alternative approach that simplifies 
changes to both pages is to create a generic address edit JSP and then pass 
that JSP to the address type as a parameter. However, in our scenario, we chose 
to introduce this new JSP to simplify the work needed in this example. 

To create the shipping address, edit the JSP based on the billing address edit 
JSP: 

1 . In the Enterprise Explorer of the Java EE perspective, expand and right-click 
Stores 0 WebContent 0 Madisons 0 mobile 0 ShoppingArea 0 
CheckoutSection 0 OrderBillingDetails.jsp. 

2. In the context menu that opens, select Copy. 

3. Right-click the CheckoutSection folder, and select Paste. 

4. The Name Conflict dialog box opens. Enter the following file name in the entry 
field, and click OK: 

OrderShi ppi ngDetai 1 s . jsp 

5. The new OrderShippingDetai Is. jsp file is displayed. To open the file in an 
editor, double-click the file name. 

6. The JSP editor opens. If the file is shown in the Design, Split, or Preview tabs, 
you can switch to the Source tab by clicking Source at the bottom of the 
window. 

7. Press Ctrl+F to open the Find/Replace window. 

8. In the Find/Replace window, enter the following information: 

Find: billing 

Replace with: shipping 

Select All for the Scope, and ensure that the “Case sensitive” and “Wrap 
search” options are selected. All other options should be cleared. 

Click Replace All. 


Important: Enter the search terms exactly as we show here, including the 
case of the letters. 
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The number of items replaced shows at the bottom of the Find/Replace 
window. In our example, we saw the following message: 

6 matches replaced 

9. Repeat the search and replace process using the following terms (notice the 
uppercase first letter of each term): 

Find: Billing 

Replace with: Shipping 

Keep all other options as in step 8. 

Again, the number of matches shows. In our example, we saw the following 
message: 

4 matches replaced 

10. Repeat the search and replace process using all uppercase spellings: 

Find: BILLING 

Replace with: SHIPPING 

Keep all other options as in step 8. 

Again, the number of matches is shown. In our example, we saw the following 
message: 

2 matches replaced 

1 1 .Click Close to close the Find/Replace window, and save the file by pressing 
Ctrl+S. 

The OrderShippingDetails.jsp file is now complete. Next, you define the 
resource bundles for the page as described in “Add localized texts” on page 284. 

Create the OrderShippingMethodSelection.jsp file 

In our scenario, we create the new OrderShippingMethodSelection.jsp from 
scratch. Refer to Figure 5-24 on page 226 for the finished look of this page. To 
create the file: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 

3. In the Enterprise Explorer, expand and right-click Stores 0 WebContent 0 
Madisons 0 mobile 0 ShoppingArea 0 CheckoutSection. 

4. In the context menu that opens, select New 0 File. 
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5. The New File dialog box opens. Enter OrderShippingMethodSelection. jsp in 
the File name field, as shown in Figure 5-34, and click Finish. 



Figure 5-34 Creating OrderShippingMethodSelection.jsp using the New File wizard 

6. The JSP file editor opens in the source tab and shows a blank page. Enter the 
skeleton JSP file shown in Example 5-30, and press Ctrl+S to save the file. 
Do not close the file yet. 

Example 5-30 Skeleton for the OrderShippingMethodSelection.jsp file 


***** 

* This JSP displays the available shipping methods and delivery date, and allows 

* the user to select the method and date for checkout 
***** 


<!-- BEGIN OrderShippingMethodSelection. jsp --> 
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<%@ taglib uri="http://java. sun.com/jsp/jstl/fmt" prefix="fmt" %> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/functions" prefix="fn" %> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/core" prefix="c" %> 

<%@ taglib uri="http://commerce. ibm.com/base" prefix="wcbase" %> 

<%@ taglib uri="http://commerce. ibm.com/foundation" prefix="wcf" %> 

<%@ include fi 1 e=" ../../. ./incl ude/parameters. jspf" %> 

<%@ include file=" . ./. ./include/JSTLEnvironmentSetup.jspf" %> 

<%@ include file=" . ./. ./include/ErrorMessageSetup.jspf" %> 

<%-- Required variables for breadcrumb support --%> 

<c:set var="shoppingcartPageGroup" value="true" scope="request"/> 

<c:set var="shippingMethodSelectionPage" value="true" scope="request"/> 

<%-- Standard parameters — %> 

<c:set var="storeId" val ue="${WCParam.storeId} " /> 

<c:set var="catalogId" value="${WCParam.catalogId}" /> 

<c:set var="addressld" val ue="${WCParam.addressId} " /> 

<%-- Retrieve Data --%> 

<! DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" 

"http://www.w3.org/TR/xhtml -basi c/xhtml -basi cl 1 .dtd"> 

<html xmlns="http://www. w3.org/1999/xhtml " 

lang="${shortLocale}" xml : 1 ang="${shortLocal e} "> 

<head> 

<title> 

<fmt: mess age key="SHIPPING_METHOD_SELECTION_TITLE" bundle="${storeText} "/> 
- <c:out value="${storeName}"/></title> 

</title> 

<meta http-equi v="content-type" content="appl i cati on/xhtml +xml " /> 

<meta http-equi v="cache-control " content="max-age=300" /> 

<meta name=" viewport" 

content="width=device-width, initial -scale=1.0, user-seal abl e=no" /> 

<1 i nk rel="stylesheet" type="text/css" href="${cssPath} " /> 

</head> 

<body> 

<div id="wrapper"> 

<%@ include fi 1 e=" . ./. ./i ncl ude/HeaderDi spl ay. jspf" %> 

<%@ include fi 1 e=" . ./. ./i ncl ude/BreadCrumbTrai 1 Di spl ay . jspf " %> 

<div id="content_box" cl ass="content_box"> 

<!-- content goes here --> 

</di v>< ! -- #content_box .content_box --> 

<%@ include fi 1 e=" . ./. ./i ncl ude/FooterDi spl ay. jspf" %> 

</di v>< ! -- Iwrapper --> 
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</body> 

</html> 

<!-- END OrderShippingMethodSelection.jsp --> 


This example code defines the JSP tag libraries that you will use, sets up the 
header with the title, and creates an empty body, including the page header 
and footer. 

You first need to retrieve the data that is needed to display the page. Apart 
from generic date information, you need to generate a list of valid shipping 
modes using the IBM_Usabl eShi ppi nglnfo access profile for the 
f i ndCurrentShoppi ngCart service of the Order component service module. 
Furthermore, in order to pre-fill the selections with the order’s current shipping 
information, if any, you need to retrieve order details from the database. In our 
scenario, we use the same f i ndCurrentShoppi ngCart expression but with the 
IBM_Detai 1 s access profile, as shown in Example 5-31 . 

Example 5-31 Service invocation of the findCurrentShoppingCart service to retrieve shipping information 

<%-- 1. Get the shipping information for the current order --%> 

<wcf :getData type= " com. ibm. commerce. order. facade. datatypes. OrderType" 
var="shi pDetai Is" express i onBui 1 der="f i ndCurrentShoppi ngCart "> 

<wcf:param name="accessProfi 1 e" val ue="IBM_Usabl eShi ppi nglnfo" /> 

</wcf :getData> 

<wcf :getData type=" com. ibm. commerce. order. facade. datatypes. OrderType" 
var="order" expressi onBui lder="fi ndCurrentShoppi ngCart"> 

<wcf:param name="accessProfi 1 e" val ue="IBM_Detai 1 s" /> 

</wcf :getData> 

<%-- 1. End Get the shipping information for the current order --%> 


7. To insert the service invocation code, in the JSP editor for the 
OrderShippingMethodSelection.jsp file, locate the following line comment: 
<%-- Retrieve Data --%> 

8. Insert the text in Example 5-31 just below the line comment. Then, press 
Ctrl+S to save the file, but do not close the file yet. 

9. Now that the data that is needed to display the available shipping modes has 
been retrieved, you can display the data. To add the shipping method display 
code to the JSP, in the JSP editor for the OrderShippingMethodSelection. jsp 
file, locate the following line comment: 

<!-- content goes here --> 
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10. Add the code shown in Example 5-32 after this line. Then, press Ctrl+S to 
save the file, but do not close the file yet. 

Example 5-32 Shipping mode selection code for OrderShippingMethodSelection.jsp 

<%-- 2. Begin Shipping Mode Selection — %> 

<form id="shippingMethod" 

action="OrderChangeServiceShipInfollpdate" 
onSubmit=" return val i date (this) "> 

<input type="hidden" name="storeId" value="${storeId}" /> 

<input type="hidden" name="catal ogld" value="${catalogId}" /> 

<input type="hidden" name="addressld" val ue="${addressld} " /> 

<input type="hidden" name="requestedShipDate" value="" /> 

<input type="hidden" name="Shi pAsCompl ete" value="Y" /> 

<c:forEach var="orderItem" items="${shipDetails.orderItem}" varStatus="status"> 
<input type="hidden" 

name="orderItemId_${ status. count}" 

val ue="$ {order Item. order I temldenti tier. uni quel D} " /> 

<input type="hidden" id="shipModeId_${status. count}" 
name="shipModeId_${status. count}" value="" /> 

</c:forEach> 

<input type="hidden" name="URL" val ue="mOrderBi 1 1 ingAddressSelection" /> 

<input type="hidden" name="errorViewName" value="mOrderShippingMethodSelection" /> 
<div class="heading_container_with_underl ine"> 

<h2> 

<fmt:message key="SHIPPING_METHOD" bundl e="${storeText} " /> 

</h2> 

<di v cl ass="cl ear_f 1 oat "></di v> 

<c:if test="${! empty errorMessage} "> 

<div id="serverError" class="error"><c:out val ue="${errorMessage} " /></div> 

</c : i f > 

</di v> 

<p class="paragraph_blurb"> 

<fmt:message key="SHIPPING_METHOD_SELECT" bundl e="${storeText} "/> 

<div id="shipMethodError" class="error"></di v> 

</p> 

<ul class="entry"> 

<%-- determine the preselected shipping mode --%> 

<c:set var= "currentshipping Info" 

val ue="${order.orderltem[0] .orderltemShi ppi nglnfo} " /> 

<c:choose> 

<%-- request parameters win (in case of a server error message) --%> 

<c:when test="${ lempty WCParam.shipModeId}"> 

<c:set var="currentShippingModeId" value="${WCParam.shipModeId}" /> 

</c:when> 
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<%-- if no request parameter, get the mode from the order info --%> 
<c:otherwise> 

<c:set var="currentShippingModeId" 

value="${currentShippingInfo.shippingMode.shippingModeIdentifier.uniqueID}" /> 
</c:otherwise> 

</c:choose> 

<c:forEach var="shippingMode" 

i tems="${shi pDetai 1 s .order I tern [0] . usabl eShi ppi ngMode} "> 

<c:set var="shipModeId" value="${shippingMode.shippingModeIdentifier}" /> 
<c:set var="shipModeExtId" val ue="${shipModeId. external Identifier} "/> 

<c:set var="uniqueID" value="${shipModeId.uniqueID}"/> 

<%-- preselect the current mode --%> 

<c:choose> 

<c:when test="${ (uniquelD eq currentShippingModeId)}"> 

<c:set var="optionChecked" val ue="checked=&quot;checked&quot; " /> 
</c:when> 

<c:otherwise> 

<c:set var="optionChecked" value="" /> 

</c:otherwise> 

</c:choose> 

<%-- Show all the shipping options available except for pickUp in Store --%> 
<c:if test="${shipModeExtId.shipModeCode != 'PickupInStore' }"> 

<c:set var="radioBtnId" value="shipModeBtn_${uniqueID}" /> 

<1 i> 

<div class="radio_container"> 

<input type="radio" id="${radioBtnId} " name="shi pModeld" 
val ue="${uniqueID} " ${optionChecked} /> 

<1 abel for="${radioBtnId} "> 

<c:out val ue="${shi ppi ngMode. descript ion. val ue} "/> 

</l abel > 

</di v> 

</l i> 

</c:if> 

</c:forEach> 

</ul> 

<%-- 2. End Shipping Mode Selection --%> 


In addition to setting up headers and defining the beginning of the form for 
submitting the shipping method, the code in this example also displays any 
error message that is received from the server in the special error <di v> with 
the ID of serverError. Note that this is separate from the empty 
shi pMethodError <di v> a few lines further down because we show form 


Chapter 5. Mobile commerce features in WebSphere Commerce V7 271 



validation errors caught by JavaScript in the context where they are found, 
while the server error messages do not carry context information. 

As shown in Figure 5-23 on page 225, in addition to the shipping method 
selection, the OrderShippingMethodSelection.jsp page also contains a 
check box that allows users to request the addition of shipping instructions, as 
well as the ability to delay shipping to a future date. 

1 1 .To add the shipping instructions check box, in the JSP editor for the 

OrderShippingMethodSelection.jsp file, locate the following line comment: 
<%— 2. End Shipping Mode Selection --%> 

12. Insert the text in Example 5-33 just below the line comment. Then, press 
Ctrl+S to save the file, but do not close the file yet. 

Example 5-33 Shipping instructions check box for OrderShippingMethodSelection.jsp 

<%-- 3. Begin Shipping Instructions --%> 

<div class="heading_container_with_underl ine"> 

<h2> 

<fmt: mess age key="SHIPPING_INSTRUCTIONS_OPT" bundle="${storeText} " /> 

</h2> 

<di v cl ass="cl ear_f 1 oat"></di v> 

</di v> 

<div id="shippingInstructions" class="entry"> 

<%-- determine if the box should be checked by default --%> 

<c:choose> 

<%-- checked in the request params (was checked by the page was redisplayed 
due to a server-side error --%> 

<c:when test="${ iempty WCParam.addShippingInstr}"> 

<input type="checkbox" id="addShippingInstr" 

name="addShippingInstr" checked= "checked "> 

</c:when> 

<%-- shipping instructions already specified on the order, so precheck --%> 
<c:when test="${ iempty currentshipping Info. shipping Instruct ion} "> 

<input type="checkbox" id="addShippingInstr" 

name="addShippingInstr" checked= "checked "> 

</c:when> 

<%-- don't precheck --%> 

<c:otherwise> 

<input type="checkbox" id="addShippingInstr" name="addShi ppi nglnstr"> 
</c:otherwise> 

</c:choose> 

<1 abel for="addShippingInstr"> 
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<fmt:message key="SHIPPING_INSTRUCTIONS_ADD" bundle="${storeText} " /> 
</l abel> 


</div> 

<%-- 3. End Shipping Instructions --%> 


13. To add the future shipping date options, in the JSP editor for the 
OrderShippingMethodSelection.jsp file, locate the following line comment: 
<%-- 3. End Shipping Instructions --%> 

14. Insert the text in Example 5-34 just below the line comment. Press Ctrl+S to 
save the file, but do not close the file yet. 

Example 5-34 Future shipping date options for OrderShippingMethodSelection.jsp 

<%-- 4. Begin Shipping Date --%> 

<div id="shippingDate" cl ass="entry"> 

<p class="paragraph_blurb"> 

<fmt:message key="SHIPPING_DATE_SELECT" bundle="${storeText} " /> 

<div id="shipDateError" class="error"></div> 

</p> 

<%-- Get current date --%> 

<jsp:useBean id="now" class="java. util .Date" scope="page" /> 

<%-- Extract the year --%> 

<fmt:formatDate var="startYear" val ue="${now} " pattern="yyyy" /> 

<%-- add two years as the max into the future --%> 

<c:set var="endYear" val ue="${startYear+2} " /> 

<%-- retrieve the current shipping date from the order --%> 

<c:set var="currentShipDate" value="${currentShippingInfo.requestedShipDate}" /> 
<%-- extract the year, month and day from the date (which is a string) --%> 

<c:if test="${ lempty currentShi pDate} "> 

<%-- pattern="yyyy-mm-ddTHH:MM:ss.SSSZ" --%> 

<c:set var="currentYear" value="${fn:substring(currentShipDate,0,4)}" /> 

<c:set var="currentMonth" value="${fn:substring(currentShipDate,5,7)}" /> 

<%-- remove prefixed zero --%> 

<c:if test="${fn:substring(currentMonth,0,l) eq 1 0 1 } "> 

<c:set var="currentMonth" val ue="${fn:substring(currentMonth, 1,2) } " /> 
</c:if> 

<c:set var="currentDay" value="${fn:substring(currentShipDate,8,10)}" /> 

<%-- remove prefixed zero --%> 

<c:if test="${fn:substring(currentDay,0, 1) eq 1 0 1 } "> 

<c:set var="currentDay" value="${fn:substring(currentDay,l,2)}" /> 

</ c : i f > 
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</c:if> 

<%-- override with whatever selection was already done --%> 

<c:if test="${ lempty WCParam.shipDay}"> 

<c:set var="currentDay" value="${WCParam.shipDay}" /> 

</c:if> 

<c:if test="${ lempty WCParam.shipMonth}"> 

<c:set var="currentMonth" value="${WCParam.shipMonth}" /> 

</c:if> 

<c:if test="${ lempty WCParam.shipYear}"> 

<c:set var="currentYear" value="${WCParam.shipYear}" /> 

</c : i f > 

<select id="shipDay" name="shipDay"> 

<option value=""> 

<fmt:message key="DAY_SELECT" bundl e="${storeText} " /> 

</option> 

<c:forEach var="day" begin="l" end="31"> 

<c:choose> 

<c:when test="${day eq currentDay} "> 

<option value="${day}" selected="selected">${day}</option> 
</c:when> 

<c:otherwise> 

<option value="${day} ">${day}</option> 

</c:otherwise> 

</c:choose> 

</c:forEach> 

</select> 

<select id="shipMonth" name="shi pMonth"> 

<option value=""> 

<fmt:message key="MONTH_SELECT" bundl e="${storeText} " /> 
</option> 

<c:forEach var="month" begin="l" end="12"> 

<c:choose> 

<c:when test="${month eq currentMonth} "> 

<option value="${month}" selected="selected"> 

</c:when> 

<c:otherwise> 

<option value="${month}"> 

</c:otherwise> 

</c:choose> 

<fmt:message key="MONTH_${month} " bundle="${storeText} " /> 
</option> 

</c:forEach> 

</select> 
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<select id="shipYear" name="shi pYear"> 

<option value=""> 

<fmt:message key="YEAR_SELECT" bundl e="${storeText} " /> 

</option> 

<c:forEach var="year" begi n="${startYear} " end="${endYear} "> 
<c:choose> 

<c:when test="${year eq currentYear} "> 

<option val ue="$ {year }"selected="selected">$ {year }</option> 
</c:when> 

<c:otherwise> 

<option val ue="$ {year }">$ {year }</option> 

</c:otherwise> 

</c:choose> 

</c:forEach> 

</select> 

</di v> 

<input type="submit" id="conti nuecheckout" name="conti nuecheckout" 

val ue="<fmt:message key="CONTINUE_CHECKOUT" bundl e="${storeText} " />" 
class="input_button_float" /> 

</form> 

<%-- 4. End Shipping Date --%> 


15. The only missing code from the JSP now is validation of the input to stop the 
form from being submitted if it is obviously wrong. To add this validation, in the 
JSP editor for the OrderShippingMethodSelection.jsp file, locate the 
following line, which specifies the end of the HTML header: 

</head> 

16. Insert the text in Example 5-35 just before the line above. Press Ctrl+S 
followed by Ctrl+W to save and close the file. 

Example 5-35 JavaScript code for validating the shipping method form 

<%-- 5. Begin Form validation and submit --%> 

<script type="text/javascript"> 

//<! [CDATA[ 

// reset all calculated form fields and error messages 
function resetForm(form) { 

document. getElementByld('shipMethodError') .innerHTML = 
document. getElementByld('shipDateError') .innerHTML = 1 1 ; 

form. requestedShipDate. value = 1 1 ; 
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function formatDate(date) { 

var formattedDate = date.getFul 1 Year() + ' - 1 ; 
var month = date.getMonth()+l; 
var day = date.getDate() ; 
if (month < 10) { 

formattedDate += 'O'; 

} 

formattedDate += month+'-'; 

if (day < 10) { 

formattedDate += 'O'; 

} 

formattedDate += day; 
return formattedDate; 

} 


// validate the form and display error messages 
// if there are problems with the input 
function val idate(form) { 

resetForm(form) ; 

// status variable, specifying whether the form is ready to be submitted 
var submitform = true; 

// determine if a shipping method has been selected 
var selectedShipModeld = ''; 

for (var i = form. shipModeld. length-1; i >= 0; --i) { 
if (form. shipModeId[i] .checked) { 

selectedShipModeld = form. shipModeId[i] .value; 
break; 



// if not, display error and stay on the page 
if (selectedShipModeld == '') { 

document . getEl ementBy Id ( ' shi pMethodError ' ) . i nnerHTML = 

"<fmt:message key="SHIPPING_METHOD_MISSING" bundl e="${storeText} "/>" 
submitform = false; 

} 

else { 

// A method has been selected. Now set this value on all the shipModeldji 
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// hidden fields. We need to do this as the order change service wants 
// a shipmode for each and every order line 

for (var i = 1; i <= ${fn:length(shipDetails.orderItem)}; i++) { 

document. get El ementBy Id ( 1 shipModeId_'+i) .val ue = sel ectedShi pModeld; 

} 


// if one of the date drop-downs have been selected, all must be 

var day = form. shipDay. value; 

var month = form. shipMonth. value; 

var year = form. shi pYear. val ue; 

var now = new Date() ; 

if (day != "" || month != "" || year != "") { 
if (day == "" || month == "" || year == "") { 

document . getEl ementBy Id ( ' shi pDateError 1 ) . i nnerHTML = 

"<fmt:message key="SHIPPING_DATE_MISSING_FIELDS" 
bundle="${storeText} 

submitform = false; 

} 

else { 

// validate the date format, utilizing a JavaScript ECMA standard 
// quirk in that using the "mm/dd/yyyy" constructor, JavaScript will 
// automatically roll to the next correct date if specifying a wrong 
// date. . . 

var date = new Date(month + "/" + day + "/" + year); 

if (date.getMonth()+l != month || 
date.getDate() != day | | 
date.getFul 1 Year() != year) { 

// if the date somehow changed, the initial values were not valid, 
document . getEl ementBy Id ( ' shi pDateError 1 ) . i nnerHTML = 

"<fmt:message key="SHIPPING_DATE_WRONG" bundle="${storeText} 
submitform = false; 

} 

else if (date <= now) { 

// display error if shipping is requested today or earlier 
document . getEl ementBy Id ( ' shi pDateError 1 ) . i nnerHTML = 

"<fmt:message key="SHIPPI NG_DAT E_EARLY " bundle="${storeText} 
submitform = false; 

} 

// date is fine. Put it into the hidden field in the format expected by 
// the shipping info update service... 
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form. requestedShipDate. value = formatDate(date) ; 

} 

} 

else { 

// all fields are empty. Prefill with tomorrow's date 

now.setDate(now.getDate()+l) ; 

form. requestedShipDate. value = formatDate(now) ; 

} 

// redirect to the shipping instructions details if the check box is checked 
if (form. addShippinglnstr. checked) { 

form. URL. val ue = 'mOrderShippinglnstructions' ; 

} 

else { 

form. URL. val ue = 'mOrderBi 1 1 i ngAddressSel ection ' ; 

} 

return submitform; 

} 

//]]> 

</script> 

<%-- 5. End Form validation and submit --%> 


The shipping method selection JSP is now complete, except for the resource 
bundles for the page that you will add, as described in “Add localized texts” on 
page 284. 

Create the OrderShippinglnstructions.jsp file 

To create the new OrderShippingMethodSelection.jsp file: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 

3. In the Enterprise Explorer, expand and right-click Stores 0 WebContent 0 
Madisons 0 mobile 0 ShoppingArea 0 CheckoutSection. 

4. In the context menu that opens, select New 0 File. 
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5. The New File dialog box opens. Enter OrderShi pping Instruct ions.jsp in the 
File name field, as shown in Figure 5-35, and click Finish. 



Figure 5-35 Creating the OrderShippinglnstructions.jsp file using the New File wizard 

6. The JSP file editor opens in the source tab and shows a blank page. Enter the 
skeleton JSP file shown in Example 5-36 into the page, and press Ctrl+S to 
save the file. Do not close the file yet. 

Example 5-36 Skeleton for the OrderShippinglnstructions.jsp file 


***** 

* This JSP displays a text area, allowing the shopper to 

* enter specific shipping instructions 
***** 

--%> 

<!-- BEGIN OrderShippinglnstructions.jsp --> 
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<%@ taglib uri="http://java. sun.com/jsp/jstl/fmt" prefix="fmt" %> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/functions" prefix="fn" %> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/core" prefix="c" %> 

<%@ taglib uri="http://commerce. ibm.com/base" prefix="wcbase" %> 

<%@ taglib uri="http://commerce. ibm.com/foundation" prefix="wcf" %> 

<%@ include fi 1 e=" ../../. ./incl ude/parameters. jspf" %> 

<%@ include file=" . ./. ./include/JSTLEnvironmentSetup.jspf" %> 

<%@ include file=" . ./. ./include/ErrorMessageSetup.jspf" %> 

<%-- Required variables for breadcrumb support --%> 

<c:set var="shoppingcartPageGroup" value="true" scope="request"/> 

<c:set var="shippingInstructionsPage" value="true" scope="request"/> 

<%-- Standard parameters — %> 

<c:set var="storeId" val ue="${WCParam.storeId} " /> 

<c:set var="catalogId" value="${WCParam.catalogId}" /> 

<%-- Retrieve Data --%> 

<! DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" 

"http://www.w3.org/TR/xhtml -basi c/xhtml -basi cl 1 .dtd"> 

<html xml ns="http://www. w3.org/1999/xhtml " 

lang="${shortLocale}" xml : 1 ang="${shortLocal e} "> 

<head> 

<title> 

<fmt: mess age key="SHIPPING_INSTRUCTIONS_TITLE" bundl e="${storeText} "/> 

- <c:out value="${storeName}"/> 

</title> 

<meta http-equi v="content-type" content="appl i cati on/xhtml +xml " /> 

<meta http-equi v="cache-control " content="max-age=300" /> 

<meta name=" viewport" 

content="width=device-width, initial -scale=1.0, user-seal abl e=no" /> 
<1 i nk rel="stylesheet" type="text/css" href="${cssPath} " /> 

</head> 

<body> 

<div id="wrapper"> 

<%@ include fi 1 e=" . ./. ./i ncl ude/HeaderDi spl ay. jspf" %> 

<%@ include fi 1 e=" . ./. ./i ncl ude/BreadCrumbTrai 1 Di spl ay . jspf " %> 

<div id="content_box" cl ass="content_box"> 

<!-- content goes here --> 

</di v>< ! -- #content_box .content_box --> 

<%@ include fi 1 e=" . ./. ./i ncl ude/FooterDi spl ay. jspf" %> 

</di v>< ! -- Iwrapper --> 

</body> 

</html> 

<!-- END OrderShippinglnstructions.jsp --> 
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The code in this example defines the JSP tag libraries that you use, sets up 
the header with title, and creates an empty body that includes the page 
header and footer. 

As shown in Figure 5-23 on page 225, the shipping instruction JSP is very 
simple and contains only a text area and a submit button. In addition to the 
visible areas, we also add JavaScript validation in this scenario, as we did for 
the OrderShippingMethodSelection.jsp shipping method. We do, however, 
still need to retrieve data for the page. Specifically, we need to retrieve order 
information in order to determine the identifiers for the order lines, to retrieve 
the current shipping instructions, if any, and to initialize the maximum number 
of characters that allowed for the shipping instructions. 

7. In the JSP editor for the OrderShippinglnstructions.jsp file, locate the 
following line: 

<%-- Retrieve Data --%> 

8. Add the code shown in Example 5-37 after this line. Press Ctrl+S to save the 
file, but do not close the file yet. 

Example 5-37 Code to retrieve shipping information for the current order 

<%-- 1. Begin Get the shipping information for the current order --%> 

<wcf :getData type= " com. ibm. commerce. order. facade. datatypes. OrderType" 
var="order" expressionBui lder="findCurrentShoppingCart"> 

<wcf:param name="accessProfi 1 e" val ue="IBM_Detai 1 s" /> 

</wcf :getData> 

<c:set var=" current Instruct ions" 

val ue="$ {order. order I tern [0] . orderltemShippinglnfo. shipping I nstructi on } " /> 

<c:if test="${ iempty WCParam.shipInstructions}"> 

<c:set var="currentInstructions" value="${WCParam.shipInstructions}" /> 

</c:if> 

<c:set var="shipInstructionsMaxLength" value="200" /> 

<%-- 1. End Get the shipping information for the current order --%> 


The code in this example retrieves the shipping details for the current order 
and sets up a variable with the current shipping instructions for the first order 
item. Furthermore, the code defines the maximum length that will be 
accepted for the shipping instructions. We set an arbitrary length of 200 
characters here, although the database field that holds the instructions can 
accept up to 4,000 characters. If you want, you can increase this limit to suit 
your needs. 

The discussion in 5.4.4, “Design new shopping flow” on page 239 revealed 
that we need to use the OrderChangeServiceShipinfoUpdate struts action to 
update the shipping instructions, as we did when we update the 
OrderShippingMethodSelection.jsp shipping method and date. 
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9. In the JSP editor for the OrderShippinglnstructions.jsp file, locate the 
following line: 

<!-- content goes here --> 

10. Add the code shown in Example 5-38 after this line. Press Ctrl+S to save the 
file, but do not close the file yet. 

Example 5-38 Shipping instruction code for OrderShippinglnstructions.jsp 

<%-- 2. Begin Shipping Instructions — %> 

<form id="shippingMethod" 

action="0rderChangeServiceShipInfollpdate" 
onSubmi t=" return val i date (this) "> 

<input type="hidden" name="storeId" val ue="${storeId} " /> 

<input type="hidden" name="catal ogld" val ue="${catal ogld} " /> 

<input type="hidden" name="Shi pAsCompl ete" value="Y" /> 

<input type="hidden" 
name="orderId" 

val ue="${shipDetai 1 s. orderldenti tier. uni quelD} " /> 

<c:forEach var="orderItem" items="${shipDetails.orderItem}" varStatus="status"> 
<input type="hidden" 

name= "order Itemld_${ status. count}" 

val ue="$ {order I tern. order I temldenti tier. uni quel D} " /> 

<input type="hidden" id="shipInstructions_${status. count} " 
name="shipInstructions_${status. count}" value="" /> 

</c:forEach> 

<input type="hidden" name="URL" val ue="mOrderBi 1 1 ingAddressSelection" /> 

<input type="hidden" name="errorViewName" value="mOrderShippingInstructions" /> 

<div class="heading_container_with_underl ine"> 

<h2> 

<fmt:message key="SHIPPING_INSTRUCTIONS" bundl e="${storeText} " /> 

</h2> 

<di v class="clear_float"></div> 

</di v> 

<p class="paragraph_blurb"> 

<fmt:message key="SHIPPING_INSTRUCTIONS_ENTER" bundl e="${storeText} "/> 

<div id="shipInstructionsError" class="error"> 

<c:out value="${errorMessage}" /> 

</di v> 

</p> 

<textarea id="shipInstructions" name="shipInstructions" 

rows="5" cols="28"><c:out value="${currentInstructions}" /></textarea> 

<p class="paragraph_blurb"> 
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<fmt:message key="SHIPPING_INSTRUCTIONS_HELP" bundl e="${storeText} "/> 
</p> 

<input type="submit" id="conti nuecheckout" name="conti nuecheckout" 

val ue="<fmt:message key="CONTINUE_CHECKOUT" bundl e="${storeText} " />" 
class="input_button_float" /> 


</form> 

<%-- 2. End Shipping Instructions --%> 


The code in this example displays the server error message within the 
shipInstructionsError <div> that is also used for JavaScript validation. This 
process is in contrast with the error message setup in the shipping method 
selection JSP that we set up earlier. We can make this change here, because 
there is only one form field and, thus, the context of the error is defined 
implicitly. 

In addition to the shipping instruction entry form, we also add JavaScript 
validation. The validation is limited to checking whether there has been any 
entry and whether the entry exceeds the maximum allowed number of 
characters. 

11. In the JSP editor for the OrderShippinglnstructions.jsp file, locate the 
following line, which specifies the end of the HTML header: 

</head> 

12. Insert the text in Example 5-39 just before this line. Press Ctrl+S followed by 
Ctrl+W to save and close the file. 

Example 5-39 JavaScript code to validate the shipping instructions form 

<%-- 3. Begin JavaScript validation and submission code --%> 

<script type="text/javascript"> 

//<! [CDATA[ 

// reset all error messages 
function resetErrors () { 

document. getElementByld('shipInstructionsError') .innerHTML = 1 1 ; 

} 


// validate the form and display error messages 
// if there are problems with the input 
function val i date (form) { 

resetErrors () ; 

// status variable, specifying whether the form is ready to be submitted 
var submitform = true; 


Chapter 5. Mobile commerce features in WebSphere Commerce V7 


283 



var shiplnstructions = form. shiplnstructions. value; 


if (Ishiplnstructions || shiplnstructions. length == 0) { 

document. get El ementBy Id ( 1 shi pi nstruct ions Error 1 ) .innerHTML = 

"<fmt:message key="SHIPPING_INSTRUCTIONS_EMPTY" bundl e="${storeText} " />"; 
submitform = false; 

} 

else if (shiplnstructions && shiplnstructions. length > 
${shipInstructionsMaxLength}) { 

document. get El ementBy Id ( 1 shi pi nstruct ions Error ' ) .innerHTML = 

"<fmt:message key="SHIPPING_INSTRUCTI0NS_T00_L0NG" bundle="${storeText} " 

/>"; 

submitform = false; 

} 

else { 

// set the instructions for each and every order line 

for (var i = 1; i <= ${fn:length(shipDetails.orderItem)}; i++) { 

document. getEl ementBy Id ( ' shi pi nstruct ions_'+i) .value = shiplnstructions; 

} 

} 

return submitform; 

} 

//]]> 

</script> 

<%-- 3. End JavaScript validation and submission code --%> 


The shipping instructions JSP is now complete. 

Add localized texts 

The JSPs created in the previous sections made references to various text 
snippets for display in the storefront. You need to add these texts to the 
properties file for the mobile store. In this example, we create only the English 
texts. To add the default English texts to the Madisons Mobile Starter Store texts: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 

3. In the Enterprise Explorer, expand and double-click Stores 0 
Java Resources: src 0 Madisons. mobile 0 storetext.properties. 
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Important: Ensure that you double-click the storetext. properties file in 
the Madi sons .mobi 1 e folder and not the Madi sons folder. 


4. When the file opens, insert the properties from Example 5-40 at the end of 
the file. Then, press Ctrl+S followed by Ctrl+W to save and close the file. 

Example 5-40 NLS texts 

# 

# Shop online - BEGIN 

# 

# Order Shipping Address Selection 
SHIPPING_ADDRESS_SELECT_TITLE = Shipping Address 
YOUR_SHIPPING_ADDRESSES = Your Shipping Addresses 
SHIPPING_ADDRESS_SELECT = Select the shipping address for your order. 
SHIPPING_ADDRESS_CREATE = To use a new shipping address, click "Create new address". 

# Order Shipping Address Details 

SHIPPING_ADDRESS_DETAILS_TITLE = Shipping Address Details 
SHIPPING_ADDRESS_TITLE = Shipping Address 

# Order Shipping Method Selection 
SHIPPING_METHOD_SELECTION_TITLE = Shipping Method 
SHIPPING_METHOD = Shipping Method 
SHIPPING_METHOD_SELECT = Choose a shipping method 

SHI PPING_INSTRUCTIONS_OPT = Optional Shipping Instructions 

SHI PPING_INSTRUCTIONS_ADD = Select this check box to add special shipping 

instructions. 

SHIPPING_DATE_SELECT = To ship at a later time, choose a date below 

DAY_SELECT = Day 

MONTH_SELECT = Month 

YEAR_S ELECT = Year 

M0NTH_1 = Jan 

M0NTH_2 = Feb 

M0NTH_3 = Mar 

M0NTH_4 = Apr 

M0NTH_5 = May 

M0NTH_6 = Jun 

M0NTH_7 = Jul 

M0NTH_8 = Aug 

M0NTH_9 = Sep 

M0NTH_10 = Oct 

M0NTH11 = Nov 

M0NTH_12 = Dec 

# JavaScript error messages. These will be put inline in a literal string 

# using double-quotes, so escape any quote or newline characters as per 
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# JavaScript code formatting rules 

SHI PPING_METHOD_MISSING = Please select a shipping method. 

SHI PPI NG_DATE_MISS I NG_FI ELDS = Select a full shipping date, or reset all date \ 
fields to request shipment as soon as possible. 

SHIPPING_DATE_WRONG = The entered date is not valid. Please correct the date. 
SHIPPING_DATE_EARLY = The entered date is too early. Please select a later date. 

# Order Shipping Instructions 

SHI PPING_INSTRUCTIONS_TITLE = Shipping Instructions 
SHI PPI NG_INSTRUCT IONS = Shipping Instructions 

SHI PPING_INSTRUCTIONS_ENTER = Enter your shipping instructions below. 

SHI PPING_INSTRUCTIONS_HELP = Max 135 characters. Examples: Leave on porch, \ 

Leave with neighbor if no answer. 

SHI PPING_INSTRUCTIONS_EMPTY = Please enter shipping instructions or go back to \ 
skip this step. 

SHI PPING_INSTRUCTIONS_TOO_LONG = The specified text for shipping instructions is \ 
too long. Please limit to 200 characters. 

# 

# Shop online - BEGIN 

# 


Test the new pages 

Now that you have created the views, set up access control, created the JSPs 
and, added the localized texts for the new pages, you can test the new pages. In 
our scenario, we test the pages through the Madisons Mobile Starter Store 
checkout flow and switch to the new custom shipping address selection page 
when the Store Locator opens. 

To test the pages: 

1 . Start or restart the test server, as described in “Analyze the current checkout 
pages” on page 229. 

2. Open a Web browser and navigate to a product page. We used Mozilla 
Firefox to navigate to a product in the catalog. We chose the violet Enzi 
Espresso Machine at the following URL: 

http : //I ocal host/webapp/wcs/stores/servl et/mProductl_10051_10051_-l_ 
10074_10345_10053_10053_catNav 

Note: The above link worked in our environment with the standard starter 
stores deployed at the time of installing IBM WebSphere Commerce V7 
Developer Edition. If you published the Madisons Starter Store manually or 
changed the catalog, this link might not work for you. If this is the case, 
navigate to find a product that is in stock both online and in one of the 
brick-and-mortar stores. 
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3. From the product page click Add to Cart. 

4. The Shopping Cart page opens with the product shown in the cart. Click 
Proceed to Checkout to continue the checkout process. 

Note: Because you have not yet customized the Shopping Cart page, you 
have to accept the option of picking up in a store. You will change to the 
shipping pages manually at a later step during the test. 

5. The sign in or checkout page opens. Click Continue Checkout to check out 
as a guest shopper. 

6. The Store Locator opens. Skip to the new shipping address selection page by 
entering the following URL in the browser’s address bar: 

https : //I ocal host/webapp/wcs/stores/servl et/mOrderShi ppi ngAddressSel 
ect i on? 1 angld=- l&catalogId= 1005 l&storeId= 10051 

Note: If your store or catalog IDs are different, you need to substitute your 
values in this link. 


7. The shipping address details page opens. Enter a new billing address, and 
click Continue Checkout. 


We entered the following information: 


Nick Name: 

First Name: 

Last Name: 

Street Address 1 : 
Street Address 2: 
City: 

Country/Region: 

State/Province: 


ITSO 

IBM Corporation 
International Technical 
Dept. HYTD Mail Station 
2455 South Road 
Poughkeepsie 
United States 
New York 


Zip code/ Postal code: 12601-5400 
Phone number: 1-800-IBM-HELP 

E-mail: redbooks@us.ibm.com 


Support Organization 
P099 


8. The shipping address selection page opens with the new address. Select the 
address, and click Continue Checkout. 

9. The shipping method selection page opens. Select a shipping method, select 
the “Select this check box to add special shipping instructions” option, and 
click Continue Checkout. 


We selected the International Regular shipping method. 

10. The shipping instructions page opens. Enter an instruction, and click 

Continue Checkout. 
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We entered the following text: 

Please leave on porch if there is no answer. 

1 1 .Because the shipping address is also a valid billing address, the billing 
address selection page opens with the shipping address that you entered in 
step 7, as shown in Figure 5-36. Select the address as the billing address, 
and click Continue Checkout. 


MADISONS MOBILE Sian In 


Your Billing Addresses 
Select the billing address for your 


ITSO 

IBM Corporation International 
Technical Support Organization 
Dept. HYTD Mail Station P099 2455 
South Road 

Poughkeepsie New York 
United States 12601-5400 
1-800-IBM-HELP 
redbooks@us.ibm.com 
» Edit 

To use a new billing address, click 
"Create new address". 

» Create new address 

Continue Checkout | 


Figure 5-36 Billing address selection page pre-filled with the shipping address 
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12. The Payment selection page opens. Note that the “Pay in Store” payment 
option is available. You will customize this page in 5.4.6, “Modify existing 
pages” on page 291 so that this option appears only when picking up from a 
store. 

In the Payment dialog box shown in Figure 5-37: 

a. Select Credit Card as the Payment Method. 

b. Select VISA Credit Card as the Card type. 

c. Enter 4111111111111111 for the Card number. 

d. Select 01 for the Month and 2010 for the Year. 

e. Enter 123 for the CVV2 Number. 

f. Click Continue Checkout. 


MADISONS MOBILE Sian In 


Payment 
Promotion Code 

Enter a promotion code to receive 
further discounts. 

Promotion Code: | 

Order Subtotal: $179.99 
Discount: ($5.00) 

Order Total: $174.99 

Update Older Total | 

Payment Method 
C Pay in Store 
(• Credit Card 


Card type 



Card number 
4111111111111111 
Month Year 



CCV2 number 



Figure 5-37 The payment method page with a test credit card number 
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13.The Order Summary page opens as shown in Figure 5-38. Notice the wrong 
label and edit link for the shipping address. We address this situation in 5.4.6, 
“Modify existing pages” on page 291 . Click Place Your Order. 


4^' MADISONS MOBILE Sign In 

Order Summary 

Review your order and select the 
"Place Your Order" button at the bottom 

Store Location 

Your items can be picked up at the 
following location. 


» Change Store 


Billing Address 


ITSO 

IBM Corporation International Technical 
Support Organization 
Dept. HYTD Mail Station P099 2455 
South Road 

Poughkeepsie New York 
United States 12601-5400 
1-800-IBM-HELP 
redbooks@us .ibm .com 


ITSO 


» Edit 


IBM Corporation International Technical 
Support Organization 
Dept. HYTD Mail Station P099 2455 
South Road 

Poughkeepsie New York 
United States 12601-5400 
1-800-IBM-HELP 


redbooks@us.ibm.c( 


Billing Method 

Payment; VISA Credit Card 
Month; 

01 

Account number; 
*********** lml 
CVV2 number; 


2010 

Amount; $174.99 


1. Enzi Espresso Machine, Violet 
SKU; EI-0101V 
In-Stock 
Price; $179.99 
Qty: 1 


Order Subtotal; $179.99 
Discount; ($5.00) 

Tax; $0.00 
Shipping; $0.00 

Order Total: $174.99 

Place Your Otdet | 


Figure 5-38 The order summary page with the wrong label and link for the shipping address 
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The order confirmation page opens as shown in Figure 5-39. Notice again the 
wrong label for the shipping address, which we will address in 5.4.6, “Modify 
existing pages” on page 291. 


■ 4 * 4 ' MADISONS MOBILE Sion In 


Thank you for your order! 

You will receive a confirmation by 
e-mail to verify your order. 
Order number: 13501 
Order date: August 13, 2009 


Store Location 

Your items can be picked up at the 
following location. 

ITSO 

IBM Corporation International Technical 
Support Organization 
Dept. HYTD Mail Station P099 2455 
South Road 

Poughkeepsie New York 


United States 12601-5400 

1-800-IBM-HELP 

redbooks@us.ibm.com 


Billing Address 

ITSO 

IBM Corporation International Technical 

Support Organization 

Dept HYTD Mail Station P099 2455 

Poughkeepsie New York 
United States 12601-5400 
1-800-IBM-HELP 
redbooks@us.ibm.com 

Billing Method 

Payment: VISA Credit Card 
Month: 

01 

Account number: 

**«*#****** llul 
CVV2 number: 


Amount: $174.99 

1. Enzi Espresso Machine, Violet 
SKU: EI-0101V 
In-Stock 
Price: $179.99 
Qty: 1 

Order Subtotal: $179.99 
Discount: ($5.00) 

Tax: $0.00 
Shipping: $0.00 

Order Total: $174.99 

Continue Shopping | 


Figure 5-39 Order confirmation page with the wrong label for the shipping address 


For a production system, you obviously need more thorough testing, for example 
testing error conditions, using the browser’s back and forward buttons, and so 
forth. We did not perform extensive testing for this scenario. An example for 
further testing is to verify that the shipping instruction page shows only when the 
corresponding check box is checked on the shipping method page. 


5.4.6 Modify existing pages 

As the analysis, design, and testing has shown, you need to modify some of the 
existing pages to support the selection of online shopping in the Madisons Mobile 
Starter Store. In this section, we explain how to make the following modifications 
to the standard Madisons Mobile Starter Store checkout pages: 

► Add checkout with shipping option to shopping cart 

► Update the sign in or check out page 

► Remove the option to pay in store from the payment page 

► Modify the order summary page to show shipping address 

► Modify order confirmation page to show shipping address 


Chapter 5. Mobile commerce features in WebSphere Commerce V7 291 


► Add breadcrumb support for new pages and flow 

► Define localized strings for customized pages 

Tip: In the following sections, we modify JSP pages that are part of the IBM 
WebSphere Commerce V7 Developer Edition standard installation. Thus, we 
recommend that you back up these files before you make any modifications to 
them so that you can always return to the original configuration. 


Add checkout with shipping option to shopping cart 

At this point, the shopping cart for the Madisons Mobile Starter Store still has 
only one option for checkout. In this section, we explain how to add an additional 
option for checkout with shipping, which results in the page as shown in 
Figure 5-24 on page 226. 

To customize the Shopping Cart page: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 

3. In the Enterprise Explorer, expand and double-click Stores 0 WebContent 0 
Madisons 0 mobile 0 ShoppingArea 0 ShopcartSection 0 
OrderltemDisplay.jsp. 

4. The file opens in the JSP source code editor. You need to locate the code that 
redirects to the sign in or checkout page. The view name for that page is 
mCheckoutLogon, as we discovered during the initial analysis. To locate this 
code, press Ctrl+F, enter mCheckoutLogon in the Find/Replace dialog box, and 
click Find. 

5. The code snippet shown in Example 5-41 is displayed. (We reformatted the 
code for readability here.) In this example, we highlighted the search term that 
was found. Click Close in the Find/Replace window. 

Example 5-4 1 Code for generating the URL for the next page in the checkout flow 

<%-- Bypass checkout logon when already signed in --%> 

<c:choose> 

<c:when test="${userType == ' G ' } "> 

<wcf:url var="CheckoutLogon" val ue="mCheckoutLogon"> 

<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

</wcf :url> 
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</c:when> 

<c:otherwise> 

<wcf :url var="CheckoutLogon" val ue="mSel ectedStoreLi stView"> 
<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 
<wcf:param name="fromPage" val ue="Shoppi ngCart" /> 

</wcf :url> 

</c:otherwise> 

</c:choose> 

<div id="shipping_options"> 

<div class="radio_container"><input type="radio" name="shipping_option" 
id="pick_up_at_store" checked /> <1 abel for="pick_up_at_store"><fmt:message 
key = " P I C K_U P_AT_S TORE" bundle="${storeText} " /></l abel ></di v> 

<button type="button" 

oncl i ck="wi ndow. 1 ocati on . href = ' $ {CheckoutLogon} 1 "><fmt :message 
key="PROCEED_TO_CHECKOUT" bundl e="${storeText} " /></button> 

</di v> 


Example 5-41 shows that the variable CheckoutLogon is set to the URL for the 
sign in or checkout page if the current user is found to be a guest user. 
Otherwise, the variable is set to the URL of the store selection list. 

The value of the CheckoutLogon variable is then used in the oncl i ck event of 
the submit button. 

Example 5-41 also shows that the sign in or checkout page itself must have 
logic that redirects to the store selection page, because the link to the sign in 
or checkout page is not given the URL for the store selection page. We 
explain how to modify this link in a later section. 

We use two hidden HTML forms to submit the page, one for each checkout 
scenario. A simple JavaScript function verifies the radio button setting and 
submits the appropriate form. 

We start by defining the revised HTML form for the current pick up in store 
action. 
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6. In the editor for the OrderltemDi spl ay . jsp file, replace the code shown in 
Example 5-41 with the code from Example 5-42. Then, press Ctrl+S to save 
the changes, but do not close the editor window. 

Example 5-42 Code to define the HTML form for check out with pick up in a store 

<wcf:url var="storeListURL" value="mSelectedStoreListView"> 

<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

<wcf:param name="orderId" value="${order.orderIdentifier.uniqueID}" /> 

<wcf:param name="fromPage" val ue="Shoppi ngCart" /> 

</wcf :url> 

<wcf :url var="shi ppi ngURL" val ue="mOrderShi ppi ngAddressSel ection"> 

<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

</wcf :url> 

<div id="shipping_options"> 

<div class="radio_container"> 

<input type="radio" name="shipping_option" id="pick_up_at_store" checked /> 

<1 abel for="pick_up_at_store"> 

<fmt:message key="PICK_UP_AT_STORE" bundl e="${storeText} " /> 

</l abel > 

</di v> 

<div class="radio_container"> 

<input type="radio" name="shipping_option" id="shop_onl ine" /> 

<1 abel for="shop_onl ine"> 

<fmt:message key="SH0P_0NLINE" bundl e="${storeText} " /> 

</l abel > 

</di v> 

<button type="button" onclick="doCheckout()"> 

<fmt:message key="PROCEED_TO_CHECKOUT" bundl e="${storeText} " /> 

</button> 

<c:choose> 

<c:when test="${userType != ' G ' } "> 

<form id="pick_up_at_store_form" action="mSelectedStoreListView"> 

<input type="hidden" name="fromPage" val ue="ShoppingCart" /> 

<input type="hidden" name="langld" val ue="${langld} " /> 

<input type="hidden" name="storeId" value="${WCParam.storeId}" /> 

<input type="hidden" name="catalogId" value="${WCParam.catalogId}" /> 
</form> 

<form id="shop_onl ine_form" act ion="mOrderShi ppi ngAddressSel ecti on "> 
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<input type="hidden" name="langld" val ue="${langld} " /> 

<input type="hidden" name="storeId" value="${WCParam.storeId}" /> 
<input type="hidden" name="catal ogld" value="${WCParam.catalogId}" /> 
</form> 

</c:when> 

<c:otherwise> 

<form id="pick_up_at_store_form" action="mCheckoutLogon"> 

<input type="hidden" name="nextURL" val ue="${storeLi stURL} " /> 

<input type="hidden" name="langld" val ue="${langld} " /> 

<input type="hidden" name="storeId" value="${WCParam.storeId}" /> 
<input type="hidden" name="catal ogld" value="${WCParam.catalogId}" /> 
</form> 

<form id="shop_onl ine_form" action="mCheckoutLogon"> 

<input type="hidden" name="nextURL" val ue="${shi ppi ngURL} " /> 

<input type="hidden" name="langld" val ue="${langld} " /> 

<input type="hidden" name="storeId" value="${WCParam.storeId}" /> 
<input type="hidden" name="catal ogld" value="${WCParam.catalogId}" /> 
</form> 

</c:otherwise> 

</c:choose> 

</di v> 


The code in this example defines a new radio button and two hidden forms 
with the information that is dependent on the shopper’s user type. 

7. Next, define the JavaScript function that submits the correct form. In the editor 
for the OrderltemDisplay.jsp file, insert the code shown in Example 5-43 
between the <head> and </head> tags at the top of the file. Then, press Ctrl+S 
and Ctrl+W to save and close the file. 

Example 5-43 Code to submit the correct form 

<script type="text/javascript"> 

//<! [CDATA[ 

/** 

* Determines which checkout flow 
*/ 

function doCheckoutQ { 

if (document. get El ementBy Id ("pi ck_up_at_store") .checked) { 
document. get El ementBy Id (" pi ck_up_at_store_form") .submi t() ; 

} 

else { 

document. get El ementBy Id (" shop_onl ine_form") .submi t() ; 

} 


//]]> 

</script> 
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The shopping cart JSP is now updated with the option for shopping online. 

Update the sign in or check out page 

As mentioned previously, the sign in or check out page contains logic to 
determine the next page in the checkout flow. Because must redirect to the new 
shipping address selection page if the shopper selects to shop online, we need to 
amend this page. 

To analyze and amend the JSP: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 

3. In the Enterprise Explorer, expand and double-click Stores 0 WebContent 0 
Madisons 0 mobile 0 UserArea 0 AccountSection 0 
LogonSubsection 0 CheckoutLogon.jsp. 

4. The file opens in the JSP source code editor. You need to locate the code that 
redirects to the store list. Press Ctrl+F, enter <button in the Find/Replace 
dialog box, and click Find. 

5. The code snippet shown in Example 5-44 is displayed. The highlighted text in 
Example 5-44 shows that the target page is controlled by the nextURL 
variable. Click Close in the Find/Replace window. 

Example 5-44 Code in the CheckoutLogon.jsp file for continuing the checkout flow 
<form id="register_l ink" action="mStoreLocatorView"> 

<fieldset> 

<p><fmt: message key="CHECKOUT_WITHOUT_SIGN_IN" bundl e="${storeText} "/></p> 
<p><fmt:message key="GUEST_CHECKOUT_MESSAGE" bundle="${storeText} "/x/p> 

<button type="button" oncl i ck="window. location. href= 1 ${nextURL} 1 "xfmt:message 
key="CONTINUE_CHECKOUT" bundl e="${storeText} "/x/button> 

</fieldset> 

</form> 


6. Press Ctrl+F, enter var="nextURL" in the Find/Replace window, and click 

Find. 
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7. The code snippet shown in Example 5-45 is displayed. Click Close in the 
Find/Replace window. 

Example 5-45 Code to generate the URL for the next page in the checkout flow 

<wcf:url var="nextURL" val ue="mSel ectedStoreLi stView"> 

<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

<wcf:param name="fromPage" val ue="Shoppi ngCart" /> 

</wcf :url> 


8. Example 5-42 on page 294 introduced a nextURL parameter to the forms that 
redirects the user to this page from the Shopping Cart page. You need to 
overwrite the value of the nextURL variable if this parameter is specified. Insert 
the code snippet shown in Example 5-46 after the code shown in 
Example 5-45. 

Example 5-46 Code to change the next page of the checkout flow dynamically 

<c:if test="${ lempty WCParam. nextURL} "> 

<c:set var="nextURL" val ue="${WCParam. nextURL} "/> 

</c : i f > 


9. Press Ctrl+S followed by Ctrl+W to save and close the file. 

After you make these modifications, follow steps 2 through 5 in “Test the new 
pages” on page 286 to test the new pages. Try the following scenarios: 

► Check out as a guest shopper, for example no login at any point 

► Check out as a registered shopper, for example log in before checkout 

► Check out as guest shopper, but log in on the sign in or check out page 

Remove the option to pay in store from the payment page 

Currently, the option to pay in the store is always included in the payment method 
page. Because this does not make sense for shoppers that choose to have the 
products shipped to them, we need to filter out this payment option from the 
payment method page unless the shopper has selected the pick up in store 
delivery option. 


Attention: In this simplified example, we remove only the option to pay in 
store from the payment method page. For a product-ready solution, you need 
to implement additional validation logic in a customized version of the 
com . i bm . commerce . order . commands . Val i datePaymen tMethodCmd task 
command. You need to implement this validation logic to prevent a malicious 
user from manipulating the request parameters. 
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To customize the payment method page: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 

3. In the Enterprise Explorer, expand and double-click Stores 0 WebContent 0 
Madisons 0 mobile 0 ShoppingArea 0 CheckoutSection 0 
OrderPaymentDetails.jsp. 

4. The file opens in the JSP source code editor. Locate the code shown in 
Example 5-47 (reformatted here for readability). 

Example 5-47 Payment method selection HTML from OrderPaymentDetails.jsp 

<%-- Enable Pay in store payment type --%> 

<c:forEach 

items="${paymentPol icyListDataBean. payment Pol icy Inf ollsableWithoutTA} " 
var="paymentPol icylnfo" varStatus="status"> 

<c:if test="${ lempty paymentPol icylnfo. attrPageName }" > 

<c:if test="${paymentPol icylnfo. attrPageName == 1 StandardPayLater 1 } "> 

<div class="radio_container"> 

<input type="radio" checked 

id="${paymentPol icylnfo. pol icyName} " 

name= " payMethod I d_rad i o " 

val ue="${ payment Pol i cy Info. pol i cyName} " /> 

<1 abel for="${ paymentPol icy Info. pol icyName} "> 

<fmt:message key="PAY_IN_STORE" bundl e="${storeText} " /> 

</l abel > 

</di v> 

</c:if> 

</c : i f > 

</c:forEach> 


We need to filter out this code if the shopper has selected the shop online 
option during checkout. We use the fact that the pay in store payment option 
is not considered a valid method by the IBM WebSphere Commerce server in 
that instance. Thus, we enumerate the available payment methods and only 
emit the above code if pay in store is among the methods. 

5. To implement this feature, add the code from Example 5-48 just before the 
first line of code shown in Example 5-47. 
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Example 5-48 Start of the block to check for the pay in store payment method 


only display payment type selection if one of the 
valid methods include "PaylnStore" 

--%> 

<c:set var="shipMode" 

val ue="${ order. order I tern [0] .orderltemShippinglnfo.shippingMode} " /> 

<c:set var="shipModeCode" 

val ue="${shi pMode. shi ppi ngModeldenti f i er .external Identi fi er . shi pModeCode} " /> 
<c:if test="${shipModeCode == 1 PickupInStore' } "> 


6. Add the code from Example 5-49 just after the last line of code shown in 
Example 5-47. 

Example 5-49 End of the block to check for the pay in store payment method 
</c : i f > 


The code in Example 5-49 removes the radio button for the pay in store 
method if the order is being shipped by showing only the radio button if the 
current shipping mode corresponds to the standard PickUpInStore mode. 
Because we simply remove one radio button in this example, the layout is 
slightly odd because the form will have a single radio button that the user has 
to select in order to pay by credit card. A more complete example removes the 
radio buttons altogether, but that method requires more substantial changes 
to the page. For this reason, we chose this simpler approach. 

7. Press Ctrl+S followed by Ctrl+W to save and close the 
OrderPaymentDetails.jsp file. 

After you make these modifications, follow steps 2 through 12 in “Test the new 
pages” on page 286 to test the new page, by skip step 6, because the logic for 
redirecting to the shipping address selection page correctly was added in the 
previous section. Try the testing with both the shop online and pick up in store 
scenarios to observe the differences on the payment details page. 

Modify the order summary page to show shipping address 

The current order summary page, as well as the order confirmation page and 
e-mail, all assume that the order does not have a shipping address, but rather a 
store location. Incidentally, the shipping address is shown, but it is presented as 
a store location, as shown in Figure 5-38 on page 290. We use the fact that an 
order that a shopper has asked to be picked up in a store is associated with a 
special shipping mode with the Pi ckupInStore code. 
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To customize the order summary page: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 

3. In the Enterprise Explorer, expand and double-click Stores 0 WebContent 0 
Madisons 0 mobile 0 ShoppingArea 0 OrderSection 0 
OrderSummaryDisplay.jsp. 

4. The file opens in the JSP source code editor. Locate the code shown in 
Example 5-50 (reformatted here for readability). 

Example 5-50 Store location display code for OrderSummaryDisplay.jsp 
<div id="store_location"> 

<h3><fmt:message key="M0_ST0RE_L0CATI0N" bundl e="${storeText} "/></h3> 

<p><fmt: message key="MO_STORE_PICK_UP_MSG" bundl e="${storeText} "/>.</p> 

<ul> 

<c:set var="contact" 

val ue="$ {order. order I tem[0] .orderltemShippinglnfo.shippingAddress} " /> 
<c:if test="${ lempty 

contact. contact Info Identifier. external Identifier.contactlnfoNickName} "> 

<1 i> 

<p><c:out 

val ue="$ {contact. contact I nfoldentifier. external Identifier.contactlnfoNickName } "/></[>> 
</li> 

</c:if> 

<1 i> 

<%-- Display shipping address of the order --%> 

<%@ i ncl ude f i 1 e=" . ./ . ./Sni ppets/Reusabl eObjects/AddressDi spl ay . jspf "%> 

</li> 

<wcf:url var="StoreURL" value="mSelectedStoreListView"> 

<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="orderId" val ue="${WCParam.orderId} " /> 

<wcf:param name="fromPage" val ue="Shoppi ngCart" /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

</wcf :url> 

<1 i> 

<span class="bullet">&#187; </span> 

<a href="${fn:escapeXml (StoreURL)}" 

ti tl e="<fmt :message key="MO_STORE_CHANGE_TITLE" 
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bundle="${storeText} "/>"><fmt:message key="MO_STORE_CHANGE" 
bundle="${storeText} "/> 

</a> 

</li> 

</ u 1 > 

</di v> 


5. Insert the code in Example 5-51 just before the code block shown in 
Example 5-50. 

Example 5-5 1 JSP code to check the shipping mode code 
<c:set var="shipMode" 

val ue="${ order. order I tem[0] .orderltemShippinglnfo.shippingMode} " /> 

<c:set var="shipModeCode" 

val ue="${shi pMode. shi ppi ngModeldenti f i er .external Identi fi er . shi pModeCode} " /> 
<c:choose> 

<c:when test="${shi pModeCode == 'PickupInStore' }"> 


6. Insert the code in Example 5-52 just after the code block shown in 
Example 5-50 on page 300. 

7. Press Ctrl+S followed by Ctrl+W to save and close the file. 

Example 5-52 Remaining code to show the shipping address and method for OrderSummaryDisplay.jsp 

</c:when> 

<c:otherwise> 

<div id="shipping_info"> 

<h3><fmt:message key="MO_SHIPPING_ADDRESS" bundl e="${storeText} "/></h3> 

<ul> 

<c:set var="contact" 

val ue="$ {order. order I tem[0] .orderltemShippinglnfo.shippingAddress} " /> 
<c:set var="contactId" 

val ue="$ {contact. contact Inf oldenti tier. external Identifier} " /> 

<c:if test="${ lempty contactId.contactInfoNickName}"> 

<1 i> 

<p><c:out val ue= "${ contact Id. contact I nfoNickName} "/ >< /p> 

</l i> 

</c : i f > 

<1 i> 

<%-- Display shipping address of the order --%> 

<%@ i ncl ude f i 1 e=" . ./ . ./Sni ppets/Reusabl eObjects/AddressDi spl ay . jspf "%> 
</li> 

<wcf :url var="ShippingAddressURL" val ue="mOrderShippingAddressSelection"> 
<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

</wcf :url> 
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<1 i> 

<span class="bul let">&#187; </span> 

<a href="${fn:escapeXml (Shi ppi ngAddressURL) } " 

title="<fmt:message key="MO_EDIT_SHIPPING_ADDR_TITLE" 
bundle="${storeText} "/>"xfmt:message key="MO_EDIT" 
bundle="${storeText} "/> 

</a> 

</li> 

</ u 1 > 

<h3><fmt:message key="SHIPPING_METHOD_SELECTION_TITLE" 
bundle="${storeText} "/></h3> 

<ul> 

<wcf :url var="Shi ppi ngMethodURL" val ue="mOrderShi ppi ngMethodSel ection"> 
<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

</wcf :url> 

<1 i> 

<p><c:out val ue="${shipModeCode} "/></ p> 

</li> 

<1 i> 

<span class="bul let">&#187; </span> 

<a href="${fn:escapeXml (Shi ppi ngMethodURL) } " 

title="<fmt:message key="SHIPPING_METHOD_SELECT" 
bundle="${storeText} "/>"xfmt:message key="MO_EDIT" 
bundle="${storeText} "/x/a> 

</l i> 

</ul> 

</di v> 

</c:otherwise> 

</c:choose> 


Note the similarities between parts of the code in Example 5-52 and the original 
store location display block from Example 5-51 on page 301 . The reason is that 
the store location is set up as the shipping information when the shopper selects 
pick up in store. We need to change the header and link information below the 
address. The latter part is the code to show the selected shipping method and 
providing a link to modify it. 

You can now test the order summary page. Note that because we introduced two 
new localized texts, these text show as errors on the page as shown in 
Figure 5-40. We describe how to add these texts in “Define localized strings for 
customized pages” on page 312. 
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MADISONS MOBILE 

Order Summary 

Review your order and select the 
"Place Your Order" button at the bottom 
of the page. 

???MO_SHIPPING_ADDRESS??? 

Default_Billing_10051 
Test UserOl 
TestUserOl 
TestuserOl Hants 
United Kingdom S021 2JN 
testuser01@example.org 


|???M0_EDIT_5HIPPING_ADDR_TITLE???| 

Billing Address 

Figure 5-40 Order summary page with shipping address and missing texts 

Modify order confirmation page to show shipping address 

The change to the order confirmation page is very similar to the change you just 
did for the order summary page, except for the simplification that there is no link 
for changing the address. To customize the order confirmation page to show the 
shipping address header instead of the store location on the order confirmation 
page: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 

3. In the Enterprise Explorer, expand and double-click Stores 0 WebContent 0 
Madisons 0 mobile 0 ShoppingArea 0 OrderSection 0 
OrderConfirmationDisplay.jsp. 
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4. The file opens in the JSP source code editor. Locate the code shown in 
Example 5-53. 

Example 5-53 Store location header 
<div id="store_location"> 

<h3><fmt:message key="M0_ST0RE_L0CATI0N" bundl e="${storeText} "/></h3> 
<p><fmt:message key="MO_STORE_PICK_UP_MSG" bundl e="${storeText} "/>.</p> 


5. Replace the code from Example 5-53 with the code in Example 5-54. 
Example 5-54 New code to display either the store location or the shipping address header 
<c:set var="shipMode" 

val ue="${ order. order I tem[0] .orderltemShippinglnfo.shippingMode} " /> 

<c:set var="shipModeCode" 

val ue="${shi pMode. shi ppi ngModeldenti f i er .external Identi fi er . shi pModeCode} " /> 
<c:choose> 

<c:when test="${shi pModeCode == 'PickupInStore' }"> 

<div id="shipping_address"> 

<h3><fmt:message key="M0_ST0RE_L0CATI0N" bundl e="${storeText} "/></h3> 
<p><fmt:message key="MO_STORE_PICK_UP_MSG" bundl e="${storeText} "/>.</p> 
</c:when> 

<c:otherwise> 

<div id="shipping_address"> 

<h3xfmt:message key="MO_SHIPPING_ADDRESS" bundl e="${storeText} "/x/h3> 
</c:otherwise> 

</c:choose> 


6. Locate the code shown in Example 5-55. 
Example 5-55 End of the shipping <div> and beginning of the billing <div> 
</di v> 

<div i d = " b i 1 1 ing_info"> 


7. Insert the code from Example 5-56 before the code in Example 5-55, for 
example, just before the </di v> tag. 

Example 5-56 New code to display either the store location or the shipping address header 

<c:if test="${shipModeCode != ' PickupInStore' } "> 

<h3xfmt message key="SHIPPING_METHOD_SELECTION_TITLE" 
bundle="${storeText} "/x/h3> 

<ul> 

<1 i> 

<pxc:out val ue="${shipModeCode} "/x/p> 
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</li> 
</ 111 > 
</c : i f > 


8. Press Ctrl+S followed by Ctrl+W to save and close the file. 

Again, after you make these modifications, follow the directions in “Test the new 
pages” on page 286 to test the customized page. You need to add the newly 
introduced localized heading for the shipping address display to the store text 
resource bundle, as shown in Figure 5-41 . We describe how to add this text in 
“Define localized strings for customized pages” on page 312. 



Thank you for your order! 


You will receive a confirmation by 
e-mail to verify your order. 

Order number: 14501 
Order date: August 14, 2009 
???MO_SH IP PING_AD DRESS??? 

Default_Billing_10051 
Test UserOl 
TestUserOl 
TestuserOl Hants 
United Kingdom S021 2JN 
testuser01@example.org 

Figure 5-4 1 Customized order confirmation page with missing localized text 

Add breadcrumb support for new pages and flow 

The breadcrumb paths in the Madisons mobile starter store are generated by a 
central JSP fragment, BreadCrumbTrailDisplay.jspf, that is included from all 
pages that need to display a breadcrumb. If you tested the pages that you added 
and modified so far, you might have noticed that the breadcrumb trail is either 
missing or incorrect for the shop online scenario. This section explains how to 
add breadcrumb support for new pages and flow. 

Add support for shop online to BreadCrumbtrailDisplay.jspf 

In this section, we explain how to modify the breadcrumb JSP fragment to 
support the new pages that were added in 5.4.5, “Create new pages” on 
page 241 , as well as the overall changes to the page flow. 
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To modify the breadcrumb JSP fragment: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 

3. In the Enterprise Explorer, expand and double-click Stores 0 WebContent 0 
Madisons 0 mobile 0 include 0 BreadCrumbTrailDisplay.jspf. 

4. The file opens in the JSP source code editor. Locate the code shown in 
Example 5-57. 

Example 5-57 Billing address selection URL variable from BreadCrumbTrailDisplay.jspf 

<wcf :url var="Bil 1 ingSelectionURL" val ue="mOrderBi 1 1 i ngAddressSel ection"> 

<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

</wcf :url> 


5. Insert the code from Example 5-58 before the code shown in Example 5-57. 
The code in Example 5-58 defines the targets for the shipping address 
selection and shipping address editing pages and is used in further code 
fragments to generate links back to these pages from further along the 
checkout flow. 

Example 5-58 Shipping address selection and editing URL variables for BreadCrumbTrailDisplay.jspf 

<wcf :url var="Shi ppi ngAddressSel ecti onURL" val ue="mOrderShi ppi ngAddressSel ecti on"> 
<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

</wcf :url> 

<wcf :url var="Shi ppi ngMethodSel ecti onURL" val ue="mOrderShi ppi ngMethodSel ecti on "> 
<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

</wcf :url> 
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6. Locate the code shown in Example 5-59 in the BreadCrumbTrai 1 Displ ay . jspf 
file. 

Example 5-59 Code to generate breadcrumb for the sign in or check out page 

<c:when test="${checkoutLogonPage} "> <%-- Checkout logon page --%> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (ShoppingCartURL)}"><fmt:message key="BCT_SHOPPINGCART" 
bundle="${storeText} " /></&> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"><fmt:message key="BCT_CHECKOUTLOGON" 
bundle="${storeText} " /></span> 

</c:when> 


7. Insert the code from Example 5-60 after the code shown in Example 5-59. 
The code in Example 5-60 generates the breadcrumb paths for the new 
pages in the checkout flow: 

- Shipping address selection 

- Shipping address create/edit 

- Shipping method selection 

- Shipping instructions 

Example 5-60 Code to generate bread crumbs for the new checkout pages 

<c:when test="${shippingSelectionPage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (ShoppingCartURL)}"><fmt:message key="BCT_SHOPPINGCART" 
bundle="${storeText} " /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"><fmt:message key="SHIPPING_ADDRESS_SELECT_TITLE" 
bundle="${storeText} " /x/span> 

</c:when> 

<c:when test="${shi ppingDetai 1 sPage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (ShoppingCartURL)}"xfmt:message key="BCT_SHOPPINGCART" 
bundle="${storeText} " /></&> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href ="$ {fn : escapeXml (Shi ppi ngAddressSel ecti onURL) } "xfmt :message 
key="SHIPPING_ADDRESS_SELECT_TITLE" bundl e="${storeText} " /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"xfmt:message key="SHIPPING_ADDRESS_DETAILS_TITLE" 
bundle="${storeText} " /x/span> 

</c:when> 
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<c : when test="$ {shi ppi ngMethodSel ecti onPage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (ShoppingCartURL)}"><fmt:message key="BCT_SHOPPINGCART" 
bundle="${storeText} " /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href ="$ {fn : escapeXml (Shi ppi ngAddressSel ecti onURL) } "><fmt :message 
key="SHIPPING_ADDRESS_SELECT_TITLE" bundl e="${storeText} " /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"><fmt:message key="SHIPPING_METHOD_SELECTION_TITLE" 
bundle="${storeText} " /></span> 

</c:when> 

<c:when test="${ shipping Instruct ions Page} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (ShoppingCartURL)}"><fmt:message key="BCT_SHOPPINGCART" 
bundle="${storeText} " /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href ="$ {fn : escapeXml (Shi ppi ngAddressSel ecti onURL) } "><fmt :message 
key="SHIPPING_ADDRESS_SELECT_TITLE" bundl e="${storeText} " /></&> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn: escapeXml (Shi ppi ngMethodSel ecti onURL) } "><fmt:message 
key="SHIPPING_METHOD_SELECTION_TITLE" bundl e="${storeText} " /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"><fmt:message key="SHIPPING_INSTRUCTIONS_TITLE" 
bundle="${storeText} " /x/span> 

</c:when> 


8. Locate the code shown in Example 5-61 intheBreadCrumbTrailDisplay.jspf 
file. 

Example 5-6 1 Code to generate breadcrumb for billing address, payment, and order summary pages 

<c:when test="${bi 1 1 ingSel ecti onPage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (ShoppingCartURL)}"xfmt:message key="BCT_SHOPPINGCART" 
bundle="${storeText} " /></&> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (StoreSel ecti onURL) }"xfmt:message key="BCT_STORESELECTION" 
bundle="${storeText} " /></&> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"xfmt:message key="BCT_BILLINGSELECTION" 
bundle="${storeText} " /x/span> 

</c:when> 
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<c:when test="${bi 1 1 i ngDetai 1 sPage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (ShoppingCartURL)}"><fmt:message key="BCT_SHOPPINGCART" 
bundle="${storeText} " /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (StoreSelectionURL)}"><fmt:rnessage key="BCT_STORESELECTION" 
bundle="${storeText} " /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href ="$ {f n : escapeXml (Bi 1 1 i ngSel ecti onURL) } "><fmt :message 
key="BCT_BILLINGSELECTION" bundl e="${storeText} " /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"><fmt:message key="BCT_BILLI NGDETAI LS" 
bundle="${storeText} " /></span> 

</c:when> 

<c:when test="${paymentSelectionPage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (ShoppingCartURL)}"><fmt:message key="BCT_SHOPPINGCART" 
bundle="${storeText} " /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (StoreSel ecti onURL) }"><fmt:rnessage key="BCT_STORESELECTION" 
bundle="${storeText} " /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn : escapeXml (Bi 1 1 i ngSel ecti onURL) } "><fmt :message 
key="BCT_BILLINGSELECTION" bundl e="${storeText} " /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"><fmt:message key="BCT_PAYMENTSELECTION" 
bundle="${storeText} " /x/span> 

</c:when> 

<c:when test="${orderSummaryPage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (ShoppingCartURL)}"xfmt:message key="BCT_SHOPPINGCART" 
bundle="${storeText} " /x/a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (StoreSel ecti onURL) } "xfmt:message key="BCT_STORESELECTION" 
bundle="${storeText} " /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href ="$ {f n : escapeXml (Bi 1 1 i ngSel ecti onURL) } "><fmt :message 
key="BCT_BILLINGSELECTION" bundl e="${storeText} " /></&> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (PaymentSel ecti onURL) }"xfmt:message 
key="BCT_PAYMENTSELECTION" bundl e="${storeText} " /></&> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 
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<span class="current_page"><fmt:message key="BCT_ORDERSUMMARY" 
bundle="${storeText} " /></span> 

</c:when> 


9. Replace each of the four lines that are highlighted in bold font in 
Example 5-61 with the code shown in Example 5-62. 

The highlighted lines in Example 5-61 generate the link to the store selection 
page, and the code in Example 5-62 generates either the store selection page 
link or links to the shipping address and shipping method pages, depending 
on the shipping mode configured for the order. 

Example 5-62 Code to generate breadcrumb links for the shipping pages 
<c:choose> 

<c:when test="${WCParam.fromPage == 'ShoppingCart' || 
order. orderltem[0] .orderltemShippinglnfo.shippingMode.shippingModeldentifier. external 
Identifier. shipModeCode == 'PickupInStore' }"> 

<a href="${fn:escapeXml (StoreSelectionURL)}"><fmt:message 
key="BCT_STORESELECTION" bundl e="${storeText} " /></a> 

</c:when> 

<c:otherwise> 

<a href ="$ {f n : escapeXml (Shi ppi ngAddressSel ecti onURL) } "><fmt :message 
key="SHIPPING_ADDRESS_SELECT_TITLE" bundl e="${storeText} " /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn: escapeXml (Shi ppi ngMethodSel ecti onURL) } "><fmt:message 
key="SHIPPING_METHOD_SELECTION_TITLE" bundl e="${storeText} " /></a> 

</c:otherwise> 

</c:choose> 


10. Press Ctrl+S followed by Ctrl+W to save and close the file. 

The conditional code in Example 5-62 shows the pickup in store breadcrumb if 
the selected shipping mode is the special Pi ckupInStore or if the request 
parameter fromPage has the value Shoppi ngCart. You need to ensure that this 
request parameter is set for the pickup in store scenario in those cases where the 
shipping mode is not yet set. 

Add breadcrumb support in SaveStoreSelection.jsp 

The SaveStoreSelection.jsp file is the page that presents the preferred store list 
and allows the shopper to select the store from which to pick up. We add the 
fromPage request parameter to the form that redirects to the billing address 
selection page to ensure that the breadcrumb shows up correctly on the billing 
address selection page. 


310 


Building Multichannel Applications with WebSphere Commerce 



To add the fromPage parameter to the SaveStoreSelection. jsp file: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 

3. In the Enterprise Explorer, expand and double-click Stores 0 WebContent 0 
Madisons 0 mobile 0 StoreLocatorArea 0 SaveStoreSelection.jsp. 

4. The file opens in the JSP source code editor. Locate the code shown in 
Example 5-63. 

Example 5-63 Code to generate billing address select URL in SaveStoreSelection.jsp 

<wcf :url var="updateItemPhysi cal Store" val ue="OrderChangeServiceItemllpdate"> 
<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

<wcf:param name="orderId" value="." /> 

<wcf:param name="URL" val ue="${WCParam.refUrl } " /> 

5. Insert the code from Example 5-64 after the code shown in Example 5-63. 

Example 5-64 Code to generate the fromPage parameter 

<wcf:param name="fromPage" val ue="${WCParam. fromPage} " /> 

The code fragment now looks similar to that shown in Example 5-65 with the 
inserted line highlighted. 

Example 5-65 Code to generate billing address select URL with fromPage for SaveStoreSelection.jsp 

<wcf :url var="updateItemPhysi cal Store" val ue="0rderChangeServiceItemllpdate"> 
<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

<wcf:param name="orderId" value="." /> 

<wcf:param name="URL" val ue="${WCParam.refUrl } " /> 

<wcf:param name="fromPage" val ue="${WCParam. fromPage}" /> 

6. Save and close the file by pressing Ctrl+S followed by Ctrl+W. 
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Define localized strings for customized pages 

As you saw when you tested the customized order summary and confirmation 
pages, you need to define a few more localized texts to the store text resource 
bundle. To add these texts: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 

3. In the Enterprise Explorer, expand and double-click Stores 0 
Java Resources: JavaSource 0 Madisons. mobile 0 
storetext.properties. 

4. The file opens. Insert the properties from Example 5-66 at the end of the file, 
and press Ctrl+S and then Ctrl+W to save and close the file. 

Example 5-66 Localized strings for the customized order summary and confirmation pages 

MO_SHIPPING_ADDRESS = Shipping Address 
MO_EDIT_SHIPPING_ADDR_TITLE = Edit shipping address 


Now that the final texts are added, you can test the entire flow. 

Note: You need to restart the server to pick up the changed resource bundle. 
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5.5 Product ratings and review 


As mentioned in “Functions not included in the Madisons Mobile Starter Store” 
on page 51 , the standard mobile pages that are delivered with the Madisons 
Mobile Starter Store do not contain hooks for the integration with third-party 
social commerce service providers as the standard Madisons Starter Store does. 
In this section, we explore how you can extend one of these features, the product 
ratings and reviews integration component that was introduced in 2.2, “Social 
Commerce” on page 52, to be used on a mobile device. 

We do not describe the steps to install and configure the Social Commerce 
feature of IBM WebSphere Commerce V7. Refer to the WebSphere Commerce 
Version 7 Information Center for detailed steps about installation and 
configuration: 

http : //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?topi c= 
/com. ibm. commerce. instal 1 .doc/tasks/t igsocdev.htm 

Furthermore, to use the code in this section, you need access to a Ratings and 
Reviews service provider, such as BazaarVoice. 

5.5.1 Ratings and reviews on the mobile device 

In this section, we discuss the social commerce features that you can add to the 
Madisons Mobile Starter Store pages. As mentioned previously, we limit the 
scope to ratings and reviews, which we implement on the following pages: 

► Product display page 

On this page, we add the overall average rating, illustrated with a number of 
stars, as well as a link to the actual reviews, should the shopper want to read 
the individual reviews. Figure 5-42 shows this page. 


Note: The product display page actually consists of four different pages: 

► Product display 

► Item display 

► Bundle display 

► Package display 

Thus, you need to update all four of these pages to add the overall ratings 
to the product page. 
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1 MADISONS MOBILE Sian In 

Home | Furniture | Mahogany Desk 
Chair 

Mahogany Desk Chair 
SKU: FUOF-Ol 


>'2 


'I 1 

Price: $249.99 

Qtv:-. 

Add to Cart | 

Overall Rating ★★★■> 

» Read Reviews (3) 

» Add to Wish List 
» Select to Compare 

Check Availability: 

S In Stock 
» Select Storefsl 

Figure 5-42 The mobile product page with overall product rating added 
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Product compare page 

Similar to the product display page, you can display the overall rating with a 
link to the individual reviews for each product shown on the product compare 
page. Figure 5-43 shows this page. 


(^MADISONS MOBILE Sian In 


Home | Furniture | Office Chairs | 
Soindle Back Chair | Product 
Compare List 

Product Compare List » Clear list 


» Remove » Remove 



Brand/model 

» Mahogany » Soindle Back 

Deal 'I hair Chair 


$249.99 $199.99 

Product Rating 
★★★★★ ★★★★★ 

(3 reviews) (0 reviews) 

Stock Availability 
Online: Online: 

& In Stock H In Stock 

Figure 5-43 Mobile product compare with ratings 

Review list 

The review list page is a new page that shows the summary information for all 
of the ratings for a given product, along with a link to the full review: 

- Rating 

- Title 

- User name 

- Review date 

Figure 5-44 shows this page. 
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MADISONS MOBILE Sian In 


Home | Furniture | Mahogany Desk 
Chair 


Reviews 

Mahogany Desk Chair 
Overall Rating: ★ ★ ★ ★ ★ 
Register to create a new review or 
Sion In in if you are already a 
member. 

Sort by: Highest rating Newest 


'[£ 


Fantastic chair! 

by: happyli on 8/25/09 
7:08PM 
» Read review 


Pretty good chair 

by: John Doe on 8/25/09 
6:26PM 
» Read review 


3 'B 


Scratched my floor :-( 

by: testl23 on 8/25/09 
6:58PM 
» Read review 


Page 1/1 


Figure 5-44 Mobile overview of reviews for a given product 
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Review details 


The review details page is a new page that presents the full details for a given 
review. Figure 5-45 shows this page. 

|/|J^ MADISONS MOB I LE Sian In 

Home 

Reviews 

Mahogany Desk Chair 
Overall Rating ★ ★ ★ ★ ★ 

Write a Review | 


, Dod chair 

By: John Doe on 8/25/09 
6:26PM 

This is a nice chair. I just received 
six for our new dining table and 
they are very fashionable. We had 
guests over for dinner and they 
were extremely impressed with the 
finish and quality of the chairs. I 
didn't even have to point out that 
the chairs were new. At this price 
they are a bargain! 

« Previous review Next review » 

« Back to reviews 


Figure 5-45 Mobile review details page 
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► Write a review 

The Write a Review page is a new page that allows the user to write a new 
review. Figure 5-46 shows this page. 



Figure 5-46 Mobile write review page 


This overview shows that most of the ratings and review pages include the 
following common elements: 

► The rating, summarized as a list of fully or partially filled out stars. 

► A button to write a new review, replaced with links to log in or register if the 
current user is not registered. 

► A header with the rating, review title, reviewer and the date and time of the 
review (common for the review list and review detail pages). 


318 


Building Multichannel Applications with WebSphere Commerce 


We consolidate the code for these fragments in JSP snippets that are included 
statically and dynamically to minimize the amount of duplication. 

In the following sections, we describe the overall technical design for the new 
pages and the detailed steps for implementing these modifications. 

5.5.2 Integration approach 

The standard Social Commerce implementation, as described in 2.2.6, “Social 
Commerce integration” on page 58, makes use of Ajax to retrieve ratings and 
reviews from the Social Commerce (Soccom) application within the shopper’s 
browser, as illustrated in Figure 2-17 on page 59. Due to the limited nature of 
mobile devices, we want to avoid heavy use of JavaScript for the purpose of 
retrieving ratings and reviews. For this reason, we implement the ratings and 
reviews on the mobile device by retrieving the data from the IBM WebSphere 
Commerce server before the page is served to the shopper. 


Note: We are not recommending that you avoid JavaScript for mobile devices. 
The standard pages for the Madisons mobile starter store uses JavaScript to 
control much of the functionality of the checkout process. However, we have 
chosen a JavaScript-light approach in this section to highlight how you can 
develop mobile pages that implement Social Commerce without relying on 
JavaScript libraries. 


Figure 5-47 and Figure 5-48 illustrate the different approaches. 
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Figure 5-47 illustrates the sequence of invocations for the Ajax approach. The 
page is returned to the browser, and then from the original request the browser 
retrieves the review data and renders the results asynchronously. 



Figure 5-47 In-browser AJAX integration to the Social Commerce (Soccom) application 


In contrast, Figure 5-48 illustrates the sequence of invocations for the in-JSP 
integration approach, where the page is not returned to the browser until the data 
is retrieved from the Social Commerce server and rendered in the JSP itself. 



Figure 5-48 In-JSP integration to social commerce (Soccom) application 
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To implement this scenario, you need to complete these steps: 

1 . Prepare the workspace. 

Before you can use the code for the social commerce widgets, you need to 
prepare your IBM WebSphere Commerce V7 Developer Edition workspace. 

2. Create the ratings and reviews data beans. 

TO encapsulate the integration code that is necessary to retrieve product 
reviews from the Soccom application, you need to develop a data bean that 
can be used from the JSPs to populate the ratings and review information for 
a given product. 

3. Create the generic star display JSP. 

Because all of the pages that you will create or modify need to display the 
rating using a number of stars, you need to create a JSP that can be included 
on the relevant pages whenever stars are needed to illustrate a given rating. 

4. Create the JSP fragment for the Write Review button. 

In recognition that several pages need logic to either display a button for 
writing a review or display sign in or log on links, you need to isolate this logic 
in a JSP snippet that is included statically. 

5. Create the JSP fragment for the review header. 

The review header with the avatar image, review title, reviewer’s user ID, and 
review date and time is used on both the review list and the review details 
page. Thus, you need to create a JSP snippet, which is included statically, 
that displays this information. 

6. Modify the product display pages. 

You need add the overall rating with a link to the rating details to all of the 
product display pages. 

7. Modify the product compare page. 

Because a major part of the buying decision for a product comparison is the 
overall rating, you also need to add the rating to the product compare page. 

8. Create the JSP for the review list and overview. 

Then, you need to create the page that displays the rating overview. 

9. Create a page for review details. 

You need to create the review details that show a single full review. 

10. Create the JSP for writing the review. 

You then create the page for submitting a new review from a mobile device. 
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1 1 .Create the command to post the review. 

You need to create the command for submitting a new review to the social 
commerce application. 

12. Modify infrastructure resources. 

Finally, you need to modify dependent resources to support the pages and 
commands that you created. 

The following sections describe these steps in detail. 

5.5.3 Prepare the workspace 

You use external libraries to deserialize JSON objects and to communicate with 
the Social Commerce application. As such, you need to prepare the IBM 
WebSphere Commerce V7 Developer Edition workspace with these libraries. 

Add the JSON library 

You need a library to deserialize the JSON objects that are returned by the Social 
Commerce application. We used the reference implementation that is available 
for download from json.org at: 
http://www.json.org/java/json.zip 

This code is only source code, so you need to compile the code and repackage it 
as a JAR file. We did this by importing the source code into a new Java project 
and exporting the JAR file as follows: 

1 . Download the j son . org source code, and save the compressed file in a 
temporary location. 

2. Switch to the Java perspective of IBM WebSphere Commerce V7 Developer 
Edition. 

3. Select File 0 New 0 Java Project. 

4. In the Project name field of the New Java Project window that opens, enter 
json.org, and click Finish. 

5. Expand json.org and select src. Then, select Import. 

6. In the Import window, expand and select General 0 Archive File, and click 
Next. 

7. On the second page of the Import wizard, enter the location of the json.zip 
file that you downloaded in step 1 in the URL field and click Finish. 

8. In the Package Explorer, right-click json.org, and select Export. 

9. In the Export window, expand and select Java 0 JAR file, and click Next. 
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10. On the second page of the Export wizard, clear the following locations: 

- .classpath 

- .project 

Then, expand json.org and select src. Clear the test option. 

1 1 .Ensure that the “Export generated class files and resources” option is select, 
enter the following file name in the JAR file entry field, and click Finish: 

WC\1 ib\json.jar 

Add the Apache HttpCIient V4.0.1 libraries 

You use the Apache HttpCIient V4.0 library to communicate with the Social 
Commerce application. Download the following files from the Apache 
HttpComponents Web site: 

► httpcomponents-cl ient-4.0. 1-bin.zip 

► httpcomponents-core-4.0. 1-bin.zip 

You can find these files by selecting the Download link from the following Web 
site: 

http://hc.apache.org/ 

After downloading these files, expand the archives to a temporary location and 
copy the files in the 1 i b directories to WC_Home \workspace\WC\l i b. Copy the 
following files: 

► httpcl ient-4.0. jar 

► httpmime-4.0. jar 

► httpcore-4.0.1.jar 

► httpcore-nio-4.0.1.jar 

Add the Social Commerce feature 

We assume that you enabled the Social Commerce features in your development 
environment, following these instructions in the information center: 

https://jtcid.hursley.ibm.com/commerce/topic/com.ibm.commerce.instal 1 .d 
oc/tasks/t igsoccom.htm 

These instructions create three new projects in the workspace: 

► SocApp 

► soccom 

► SocCore 
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5.5.4 Create the ratings and reviews data beans 


As mentioned previously, you encapsulate the logic for retrieving the review 
overview and details from the Social Commerce application within a data bean, 
which enables JSP developers to use JSTL tags to instantiate and populate 
review details within the JSPs themselves. 

In our scenario, we develop the following beans: 

► A smart data bean, ReviewsDataBean, which is instantiated on the JSPs that 
use the <wcf :useBean> tag. 

► A value object, Revi ewDetai 1 Bean, which holds details of each review. This 
bean is returned as a LinkedHashMap from ReviewsDataBean. The individual 
values in this value object can be accessed through getter and setter 
methods. 

We provide details about these beans in the following sections. 

Create the ReviewsDataBean class 

This data bean extends SmartDataBeanlmpl and is used to retrieve the review list 
and details for an item or product by querying the sMash application. The main 
responsibilities of the bean are to send the request to the sMash application and 
then parse the response. The request is submitted as an HTTP request, and the 
response is a JSON object. If the HTTP request is a POST request, the post data 
contains a JSON object that details the request. 

For more information, refer to the REST API topic in the WebSphere Commerce 
Version 7 Information Center at: 

http://publib.boul der.i bm.com/ i nfocenter/wchel p/v7r0m0/topi c/com. i bm.co 
mmerce.soccom. doc/ref s/rsmsocrestapi .htm 

For retrieving a list of reviews, you need to send a GET request to the URL: 
/items/ if em/D/reviews 

Where itemlD is a unique reference to the SKU for which you want to retrieve the 
reviews. The response is a JSON object of the structure outlined in 
Example 5-67. 

Example 5-67 Review list response syntax 
_ 

"status": { "type": "integer" }, 

"message": { "type": "string" }, 

"data": { 

"id":{ "type": "string" }, 
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"ratingStatistics":{ "type": "ratingStatistics" }, 
"paginationDetails":{ "type":"paginationDetails" }, 
"reviews":! "type": "array", "arrayType": "review" } 

} 

} 


Example 5-68 shows a sample response for review list query from the Social 
Commerce application. 

Example 5-68 Review list response 

{ "status" : 200, "message" : " " , "data" : { "rati ngStati sti cs" : { "rati ngRange" : { " 
upperBound " : 5 , " 1 owerBound " : 0} , " numOfOveral 1 Ratings" : " 1 " , "avgOveral 1 Rati 
ng" : 5 . 0} , "pagi nati onDetai 1 s" : { "sortDi recti on" : "desc" , "noOf Entri esPerPag 
e" : 10, "noOfTotal Entries" : 1, "pageNum" : l,"sortType" : "defaul t" , "noOf Total P 
ages": 1} , "reviews" : [{"reviewld" : 1," rating " : 5," itemld" : "FUL0-01","ItemDe 
scription":"FUL0-01","reviewText":"This is a test review", "title" : "test 
review" , "i sRati ngOnly" : "fal se" , "userid" : "wcsadmi n" , "recommend" : "true" , " 
userid":"wcsadmin","submissionTime":"2009-08-26T18:57:56.031"}] ,"id":"F 
UL0-01 " } } 


To implement the ReviewsDataBean: 

1 . Create a new package, com. xxx. commerce. soccom. beans, where xxx is the 
name of your company in the WebSphereCommerceServerExtensionsLogic 
project. 


Note: The chosen package name is just an example. The name can be 
anything per your guidelines. For our development, we used the name 
com . i bm . i tso . commerce . soccom. beans . 


2. Create a new class, ReviewsDataBean, under this created package. This data 
bean extends com. ibm. commerce. beans. SmartDataBeanlmpl and implements 
com .ibm. commerce . beans . SmartDataBean . 

3. Add the constructor and attributes to the class as shown in Example 5-69. 
The attributes that you add are the input parameters that are required by the 
sMash application and the output elements that are returned from sMash as a 
result of fetching the reviews. 

In addition to the attributes and constructor, the code in Example 5-69 also 
contains utility methods for setting and querying the bean’s error state. 
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Note: Some of the types in Example 5-69 refer to packages that you have 
not yet imported. As such, you will see some compilation errors in the 
Problems view. We explain how to add the package import statements and 
resolve these errors in a later step. 


Example 5-69 Attributes and constructor for ReviewsDataBean 

/** constant for specifying a non-initial ized integer */ 
private static final int INT_N0_SET = -1; 

/** sets the number of reviews to be displayed on a page */ 
private int pageSize = INT_N0_SET; 

/** sets the page number */ 
private int onPage = INT_N0_SET; 

/** sets the sort type & sort direction of the results. 

* Its format is sort type | sort direction. Valid values for sort 

* type are “rating” and “submissionTime“. Valid values for sort 

* direction are “asc” & “desc“. */ 
private String sortOptions; 

/** sets the Part number for which results are needed. */ 
private String partNumber; 

/** total number of ratings for the product. */ 
private int numOfOveral 1 Ratings; 

/** this is average overall rating for the product. */ 
private double avgOveral 1 Rating; 

/** Lower bound used to calculate the average rating. */ 
private int lowerBound; 

/** Upper bound used to calculate the average rating */ 
private int upperBound; 

/** Sorted map of reviewld and ReviewDetai 1 Bean */ 
private LinkedHashMap<String, ReviewDetai 1 Bean> reviewDetai 1 sMap; 
/** Sort direction used for sorting */ 
private String sortDi recti on; 

/** Number of results returned by sMash application, to be 

* displayed on a page. - used in Pagination */ 
private int noOfEntriesPerPage; 

/** Total number of reviews for the product */ 
private int noOfTotal Entries; 

/** Current page number - used in pagination */ 
private int pageNum; 

/** Sort type used for sorting */ 
private String sortType; 

/** Number of total pages - Used in pagination */ 
private int noOfTotal Pages; 

/** The error message for display */ 
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private String errorMessage = null; 

/** Any exception data. No error if <code>nul l</code> */ 
private Throwable errorException = null; 

/** Constant for use in tracing and error handling */ 
private static final String CLASS_NAME = 

Revi ewsDataBean . cl ass .getName () ; 

/** Logging and tracing instance */ 
private static final Logger LOGGER = 

Logger. getLogger(CLASS_NAME) ; 

/** Constructor. Will only initialize the reviewDetai 1 sMap */ 
public ReviewsDataBean() { 
reviewDetailsMap = 

new LinkedHashMap<String, ReviewDetai 1 Bean>() ; 

} 

/** Set the error message and optional exception in one call. 

<code>t</code> may be <code>nul l</code> */ 
private void setErrorState(String error, Throwable t) { 
errorMessage = error; 
errorException = t; 

} 

/** Return whether an error has been reported */ 
public boolean isErrorQ { 

return errorMessage != null || errorException != null; 

} 


4. Add accessor methods for these variables. Add setter methods for all the 
inputs parameters and getter methods for all the output elements. Add the 
accessor methods from Example 5-70. (The code in Example 5-70 is shown 
in compact form.) Press Ctrl+Shift+F to reformat the source code if you want. 

Example 5-70 Accessor methods for ReviewsDataBean 

public String getErrorMessageQ {return errorMessage;} 
public Throwable getErrorExceptionQ {return errorException;} 
public int getNumOfOveral 1 Ratings () {return numOfOveral 1 Ratings;} 
public double getAvgOveral 1 RatingQ {return avgOveral 1 Rati ng; } 
public int getLowerBoundQ {return lowerBound;} 
public int getUpperBoundQ {return upperBound;} 
public LinkedHashMap<String, ReviewDetai 1 Bean> getReviewDetailsMapO 
{return reviewDetailsMap;} 

public String getSortDirectionQ {return sortDirection;} 
public int getNoOfEntriesPerPage() {return noOfEntriesPerPage;} 
public int getNoOfTotal Entries () {return noOfTotal Entries;} 
public int getPageNum() {return pageNum;} 
public String getSortTypeQ {return sortType;} 
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public int getNoOfTotal PagesQ {return noOfTotal Pages; } 

public void setPageSize(int pageSize) {this.pageSize = pageSize;} 

public void setOnPage(i nt onPage) {this.onPage = onPage;} 

public void setSortOptions (String sortOptions) {this.sortOptions = 

sortOptions;} 

public void setPartNumber(Stri ng partNumber) {this.partNumber = 
partNumber;} 


5. Add the popul ate method shown in Example 5-71 to the Revi ewsDataBean 
class. The populate method mainly performs tracing and error handling, 
referring the request and response handling to the executeRequest and 
handleResponse methods, which you will add later. 

Example 5-71 Populate method of ReviewsDataBean 

public void populateQ { 

final String METHOD_NAME = "populate"; 

LOGGER. entering (CLASS_NAME, METHOD_NAME) ; 

String response = ""; 
try { 

if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. logp( 

Level. FINE, CLASS_NAME, METHOD_NAME, 

"partNumber: \"{0}\", pageSize: \"{1}\","+ 

"onPage: \"{2}\", sortOptions: \"{3}\"", 
new String [] { 

partNumber, String. val ueOf (pageSize) , 

String. val ueOf (onPage) , sortOptions }); 

} 

if (partNumber != null) { 

response = executeRequest () ; 

} 

else { 

// signal missing parameter with an empty exception, 

// just to keep it non-null 

String message = "Missing parameter \"partNumber\"" ; 
LOGGER. logp(Level .SEVERE, CLASS_NAME, METHOD_NAME, 
message) ; 

setErrorState(message, new Exception(message)) ; 

} 

} catch (Exception e) { 

String message = 

"Exception in trying to retrieve review details"; 
LOGGER. logp(Level .SEVERE, CLASS_NAME, METHOD_NAME, 
message, e); 
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setErrorState(message, e); 


} 

if (response != null && !response.equals("")) { 
handleResponse(response) ; 

} 

LOGGER. exiting(CLASS_NAME, METHOD_NAME) ; 


6. Add the executeRequest method as shown in Example 5-72 to the 

Revi ewsDataBean class. This method creates the necessary HttpCIient objects 
to open and execute an HTTP request against the Social Commerce 
application, passing in the parameters set by the calling JSP as HTTP GET 
parameters. 

The method then retrieves the response from the Social Commerce 
application as a String object if the HTTP response code is in the 200 to 400 
range, for example not a known HTTP error code. Otherwise, an error state 
variable is set. 

Example 5-72 Source code for the executeRequest method 

private String executeRequest () 

throws URISyntaxException, IOException, 

Cl i entProtocol Exception { 

final String METHOD_NAME = "executeRequest"; 

LOGGER. enteri ng(CLASS_NAME, METHOD_NAME) ; 

String response = 

HttpCIient client = new Defaul tHttpCl ient() ; 

//TODO: make socket timeout configurable 

cl ient.getParams() .setParameter("http. socket. timeout", 5000) ; 

cl ient.getParamsQ .setParameter( 

"http. protocol .content-charset" , "utf-8") ; 

List<NameValuePair> params = new Li nkedLi st<NameVal uePair>() ; 
if (pageSize != INT_N0_SET) { 

params . add (new Basi cNameVal uePai r ( "pageSi ze" , 

String.val ueOf (pageSize))) ; 

} 

if (onPage != INT_N0_SET) { 

params .add (new Basi cNameVal uePai r ( "onPage" , 

String.val ueOf (onPage))) ; 

} 

params . add (new Basi cNameVal uePai r ( "sortOpti ons" , sortOpti ons) ) ; 
//T0D0: make request URI values configurable 
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String url Scheme = "http"; 

String urlHost = "localhost"; 
int url Port = 80; 

String url Path = "/soccom/api/i terns/" + partNumber + "/reviews"; 
URI uri = URIUtils.createURI( 

url Scheme, urlHost, url Port, url Path, 
URLEncodedUtils.format(params, "UTF-8"), null); 
if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. logp(Level. FINE, CLASS_NAME, METH0D_NAME, 

"URI: \"{0}\"", uri); 

} 

HttpGet method = new HttpGet(uri ) ; 

//T0D0: make socket timeout configurable 

method. getParamsQ .setParameter("http. socket. timeout", 5000) ; 

// Execute request 

HttpResponse httpResponse = cl ient.execute(method) ; 

int statuscode = httpResponse. getStatusLine() .getStatusCode() ; 

if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. logp(Level. FINE, CLASS_NAME, METH0D_NAME, 

"HTTP status code: {0}", statuscode); 

} 


if (statuscode >= 200 && statuscode < 400) { 

// Read the response body. 

HttpEntity entity = httpResponse. getEntityQ ; 
if (entity != null) { 

long len = entity. getContentLengthQ ; 
if (len ! = -1) { 

response = EntityUtils.toString(entity); 

} 

} 


if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. logp(Level .FINE, CLASS_NAME, METH0D_NAME, 
"HTTP response: \"{0}\"", response); 

} 


else { 

String message = "Error code from soccom: "+statuscode; 
LOGGER. logp(Level .SEVERE, CLASS_NAME, METH0D_NAME, 
message) ; 

setErrorState(message, new Excepti on (message) ) ; 
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} 

LOGGER. exiting(CLASS_NAME, METHOD_NAME, response); 
return response; 


7. Add the handl eResponse method as shown in Example 5-73 to the 
ReviewsDataBean class. This method uses the JSON API provided by 
json.org to parse the JSON object that is returned from the Social 
Commerce application. 

The header-level return values are first retrieved and stored in attributes to the 
ReviewsDataBean. Then, each review returned is retrieved and a 
Revi ewDetai 1 Bean is populated and added to the revi ewDetai 1 sMap, which is 
a mapping from review ID to Revi ewDetai 1 Bean instances. 

Example 5-73 The source code for the handleResponse method 

private void handl eResponse(Stri ng response) { 
final String METHOD_NAME = "handleResponse"; 

LOGGER. entering (CLASS_NAME, METHOD_NAME, response); 
try { 

JSONObject json = new JSONObject(response) ; 
if (json.getInt("status") == 200) { 

JSONObject data = json.getJSONObject("data") ; 

JSONObject rati ngStati sties = data 

.getJS0N0bject( "rati ngStati sties"); 
numOfOveral 1 Ratings = 

rat i ngStati sties. get I nt("numOfOveral 1 Ratings") ; 
if (numOfOveral 1 Ratings > 0) { 
avgOveral 1 Rating = 

rati ngStati sti cs .getDoubl e( "avgOveral 1 Rating") ; 


JSONObject ratingRange = 

rati ngStati sti cs .get JSONObject ("rati ngRange") ; 
upperBound = ratingRange. getInt("upperBound") ; 
lowerBound = ratingRange. getInt("lowerBound") ; 
if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. logp(Level .FINE, CLASS_NAME, METHOD_NAME, 

"numOfOveral 1 Ratings: {0}, avgOveral 1 Rati ng: {1}," 
+" upperBound: {2}, lowerBound: {3}", 
new Object [] { numOfOveral 1 Ratings, 

avgOveral 1 Rating, upperBound, lowerBound} ); 

} 

JSONObject paginationDetai 1 s = 

data . get JSONObj ect ( " paginationDetai Is"); 
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sortDirection = paginationDetails 
.getString("sortDirection") ; 
noOfEntriesPerPage = paginationDetails 
.getInt("noOfEntriesPerPage") ; 
noOfTotal Entries = paginationDetails 
.getInt("noOfTotal Entries") ; 
pageNum = paginationDetails. getInt("pageNum") ; 
sortType = paginationDetails. getString("sortType") ; 
noOfTotal Pages = 

paginationDetai 1 s.getInt("noOfTotal Pages") ; 

JSONArray reviews = data.getJSONArray("reviews") ; 
if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. logp(Level. FINE, CLASS_NAME, METHOD_NAME, 

"Found {0} reviews", reviews. length()) ; 

} 

if (reviews. length () > 0) { 

JSONObject review = null; 

ReviewDetailBean reviewDetail s = null; 
for (int i = 0; i < reviews. length() ; i++) { 
review = reviews. getJSONObject(i) ; 
reviewDetails = new ReviewDetai 1 Bean() ; 
revi ewDetai 1 s . setRati ngOnl y (revi ew 
.getBool ean ("i sRati ngOnl y") ) ; 
revi ewDetai ls.setItemId(review.getString("i temld")) ; 
revi ewDetai 1 s . setRati ng (revi ew. get Int ( "rati ng") ) ; 
if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. logp(Level .FINE, CLASS_NAME, METH0D_NAME, 
"rating ", review. getlnt("rati ng")) ; 

} 

int reviewld = review. getlnt("reviewld") ; 
revi ewDetai 1 s . setRevi ewld (revi ewld) ; 
revi ewDetai 1 s . setRevi ewText (revi ew 
.getString("reviewText")) ; 
revi ewDetai 1 s . setSubmi ssi onT i me (revi ew 
.getString("submissionTime")) ; 
revi ewDetai 1 s. setTi tl e(revi ew. getStri ng ( "ti tl e") ) ; 
revi ewDetai ls.setUserld (revi ew.getString( "userid") ) ; 
// Important! Use strings as the map key! 
revi ewDetai lsMap.put(String.val ueOf (reviewld) , 
reviewDetails); 

if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. logp(Level .FINE, CLASS_NAME, METH0D_NAME, 
"Review # { 0} : {1}", 
new Object [] { i , reviewDetails} ); 
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} 

} 

} 

} 

} catch (Exception e) { 

LOGGER. logp(Level. SEVERE, CLASS_NAME, METHODJAME, 

"Exception in trying to parse review details", e) ; 
setErrorState("Exception in trying to parse review details", 
e); 

} 

LOGGER. exiting(CLASS_NAME, METHODJAME); 

} 


You will notice a number of errors due to missing import statements. You can 
remedy these errors using the Organize Imports function of IBM Rational 
Application Developre V7.5. However, given the number of classes that we 
depend on and the ambiguity of these classes, it is simpler to just add these 
manually. 

8. Add the imports shown in Example 5-74 to the top of the ReviewsDataBean 
source code, just after the package statement. Save the file by pressing 
Ctrl+S. 

Example 5-74 Import statements for ReviewsDataBean 

import java.io.IOException; 
import java. net. URI; 
import java.net . URISyntaxExcepti on ; 
import java. util .LinkedHashMap; 
import java. util .LinkedList; 
import java. util .List; 
import java. util .logging. Level ; 
import java. util .logging. Logger; 

import org. apache. http. HttpEntity; 

import org. apache. http. HttpResponse; 

import org .apache. http . NameVal uePai r ; 

import org. apache. http. cl ient. Cl ientProtocol Exception; 

import org. apache. http. cl ient. HttpCl ient; 

import org. apache. http. cl ient. methods. HttpGet; 

import org. apache. http. cl ient. util s.URIUti Is; 

import org .apache. http. cl i ent . uti 1 s . URLEncodedUti 1 s ; 

import org. apache. http. impl .cl ient. Defaul tHttpCl ient; 

import org. apache. http. message. BasicNameVal uePai r; 

import org. apache. http. util . Ent i tyllt i Is; 

import org.json. JSONArray; 
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import org.json. JSONObject; 

import com . i bm . commerce . beans . SmartDataBean ; 
import com. ibm. commerce. beans. SmartDataBean Impl ; 


The ReviewsDataBean is now functionally complete, but to simplify debugging, 
you add a toString method that summarizes the information that the bean 
contains. 

9. Add the toStri ng method as shown in Example 5-75 to the ReviewsDataBean 
and press Ctrl+S to save the file. 

Example 5-75 Source code for the toString method for ReviewsDataBean 

public String toString() { 

StringBuffer buf = new Stri ngBufferQ ; 

buf. append ("{avgOveral 1 Rating=") . append (avgOveral 1 Rating) ; 

buf .append (",lowerBound=") . append ( 1 owerBound) ; 

buf .append (",upperBound=") . append (upperBound) ; 

buf .append (",noOf Entries PerPage=") . append (noOfEntriesPerPage) ; 

buf .append (".noOfTotal Entries=") . append (noOf Total Entries) ; 

buf .append (",noOfTotalPages=") . append (noOfTotal Pages) ; 

buf .append (",numOfOveral 1 Ratings=") . append (numOfOveral 1 Ratings) ; 

buf .append(",onPage=") .append(onPage) ; 

buf .append(",pageNum=") .append(pageNum) ; 

buf .append(",pageSize=") .append(pageSize) ; 

buf .append (",partNumber=") .append (partNumber) ; 

buf .append (".sortDi recti on=") . append (sortDi recti on) ; 

buf .append (",sortOptions=") .append (sortOpt ions) ; 

buf .append(",sortType=") .append(sortType) ; 

buf .append (".reviewDetai 1 sMap=") .append (reviewDetai 1 sMap) ; 

buf .append(",errorMessage=") .append(errorMessage) ; 

buf .append (",errorException=") . append (errorExcept ion) ; 

buf .append("} ") ; 

return buf .toString() ; 

} 


The ReviewsDataBean is now complete. You will notice some compilation errors 
relating to missing ReviewDetai 1 Bean. You create this bean in the next section 
and resolve the compilation errors. 

Create the ReviewDetailBean class 

The ReviewDetai 1 Bean class is a data transfer object (DTO) that encapsulates 
the Review detail data and has getter and setter for each of the values. This bean 
is used on JSP pages to display the review details. 
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To create the ReviewDetailBean class: 

1. Create a new class, ReviewDetailBean, that inherits from java. lang. Object 
under the same package that is used for the ReviewsDataBean class. 

2. Add the attributes to the class as shown in Example 5-76. 

Example 5-76 Attributes for ReviewDetailBean 

/** <code>true</code> if this is a rating with no review */ 
private boolean isRatingOnly; 

/** ID of this review. Used for later retrieving review details */ 
private int reviewld; 

/** Main review text. Usually several paragraphs. */ 
private String reviewText; 

/** ID of the submitter of the review */ 
private String userid; 

/** A one-line title of the review */ 
private String title; 

/** Timestamp of the submission in ISO format */ 
private String submissionTime; 

/** Rating (0..5) */ 
private int rating; 

/** The part number of the product being rated */ 
private String itemld; 


3. Add accessor methods for these variables. To add the necessary accessor 
methods: 

a. With the cursor within the class source code, select Source 0 Generate 
Getters and Setters. 

b. When the Generate Getters and Setters window opens, click Select All 
and click OK. 

c. Press Ctrl+S to save the file. 

4. As shown in Example 5-68 on page 325, the submission time is returned in 
ISO format. For the JSPs that use the ReviewDetai 1 Bean to be able to format 
the submission time correctly for display, you need to introduce a method that 
parses the String version of the submission time stamp and returns it as a 
java.uti 1 .Date object. The JSPs can then use the date formatting tags 
within JSTL to format the time stamp. Add the method shown in Example 5-77 
to provide this capability. 

Example 5-77 Source code for getSubmissionTimeAsDate method 
public java.uti 1 .Date getSubmissionTimeAsDate() { 
java. text. SimpleDateFormat sdf = new 

java. text. Si mpleDateFormat("yyyy-MM-dd 1 T 1 hh:mm:ss.SSS") ; 
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try { 

java. uti 1 .Date d = sdf.parse(getSubmissionTime()) ; 
return d; 

} catch (java. text. ParseException e) { 
return nul 1 ; 


} 


5. As with the ReviewsDataBean, the final step is to add a toString method for 
debugging purposes. Add the method shown in Example 5-78, and press 
Ctrl+S to enable and save the file. 


Example 5-78 Source code for toString method of ReviewsDataBean 

public String toString() { 

StringBuffer buf = new Stri ngBufferQ ; 
buf .append("{") ; 

buf .append("reviewld: ") .append(reviewld) ; 

buf .append(", itemld: ") .append(itemld) ; 

buf .append(", userid: ") .append(userld) ; 

buf .append(", submissionTime: ") .append(submissionTime) ; 

buf .append(", rating: ") .append(rating); 

buf .append(", title: ") .append(title) ; 

buf .append(", reviewText: ") .append(reviewText) ; 

buf.append("}"); 

return buf .toString() ; 


5.5.5 Create the generic star display JSP 

In recognition that all of the pages that show ratings and reviews need to be able 
to illustrate the current rating with a number of fully or partially filled out stars, you 
need to create a utility JSP that can be included on such pages. You create this 
JSP as a JSP that is included dynamically to ensure that the JSP is independent 
from the including JSP, as well as to enable the JSP to be configured for fragment 
caching. 


Important: We do not consider caching configuration in this example. We 
recommend that you review the caching design of your site before using any of 
this code on a production environment. As an example, the Social Commerce 
application might return ratings with any number of fractional digits. We round 
the digits in this JSP, but a more complete approach from a caching 
perspective is to round in the data bean. 
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Because the actual scale used is part of the data that is returned from the Social 
Commerce server, the JSP needs to be capable of showing a rating using any 
scale. Also, you need to allow a fractional rating to display by showing partially 
filled stars, as shown in Figure 5-49. 


★★★★★ 

1.2 

★ ★ ★ ★ 

3.3 

★ ★★★★ 

4.0 


Figure 5-49 Three different star ratings 

To create the star rating JSP, StarRating.jsp, follow these steps: 

1 . In the Java EE perspective of IBM WebSphere Commerce V7 Developer 
Edition, expand and right-click Stores 0 WebContent 0 Madisons 0 
mobile 0 Snippets 0 ReusableObjects and select New 0 File. 

2. In the New File wizard, enter StarRating.jsp in the File name entry field. 
Ensure that the parent folder entry field contains the following path, as shown 
in Figure 5-50, and click Finish: 

Stores/WebContent/Madi sons/mobi 1 e/Sni ppets/Reusabl eObjects 
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Figure 5-50 Entering the name for the new StarRating.jsp file in the new file wizard 

3. The JSP editor opens. Add a comment to introduce the use of the utility JSP, 
declare the JSTL tags to be used, and define a few constants. 

4. In the JSP editor, enter the code shown in Example 5-79. and press Ctrl+S to 
save the file. 

Example 5-79 Header and constants for StarRating.jsp 


***** 

* This JSP snippet displays a star rating 

* Mandatory parameters: 

* - lowerBound: The min value for a rating 

* - upperBound: The max value for a rating 

* - rating: The average rating (number of stars to display). 

* This does not have to be integer 


338 


Building Multichannel Applications with WebSphere Commerce 


* Sample invocation: 

* <c: import url ="${ jspStoreDi rjmobi le/Snippets/ReusableObjects/StarRating. jsp"> 

* <c:param name="l owerBound" value="0" / 

* <c:param name="upperBound" value="5" /> 

* <c:param name="rati ng" value="3.7534" /> 

* </c:import> 


<%@ taglib uri="http://java. sun.com/jsp/jstl/core" prefix="c" %> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/functions" prefix="fn" %> 

<%-- Constants for image file names --%> 

<c:set var="starImgPath" value="/soccom/ibm/social/images/" /> 

<c:set var="emptyStar" val ue="${starImgPath}star_grey.png" /> 

<c:set var="ful IStar" val ue="${starImgPath}star_ful 1 . 10. png" /> 

<c:set var="fractionStarPrefix" val ue="${starImgPath}star_ful 1 . " /> 
<c:set var="fractionStarSuffix" value=".png" /> 


5. Add the code in Example 5-80 to the end of the StarRating.jsp, and press 
Ctrl+S to save the file. 

Example 5-80 Retrieving parameters and determining the fractional rating for StarRating.jsp 
<%-- Retrieve parameters --%> 

<c:set var="l owerBound" value="${param.lowerBound}" /> 

<c:set var="upperBound" val ue="${param.upperBound} " /> 

<c:set var="rating" val ue="${param. rating} " /> 

<%-- determine integer and fraction parts --%> 

<c:set var="ratingArr" val ue="${fn:spl it(rating, /> 

<c:set var="ratinglnt" val ue="${rati ngArr[0] } " /> 

<c:set var="ratingFrac" value="0" /> 

<%-- was there a fractional part? --%> 

<c:if test="${fn:length(ratingArr) > 1}"> 

<%-- we only care about the first digit of the fractions (with rounding) --%> 
<c:set var="ratingFrac" val ue="${fn:substring(ratingArr[l] ,0,1)}" /> 

<%-- round up if the second digit after the decimal point is above four --%> 
<c:if test="${fn:length(ratingArr[l])>l && fn:substring(ratingArr[l] ,1,2)>4}"> 
<c:set var="ratingFrac" val ue="${rati ngFrac+1} " /> 

</c : i f > 

</c : i f > 

<%-- define the accessibility text to be used for the images --%> 

<c:set var="ratingAltText" val ue="${rati nglnt} .${ratingFrac} " /> 
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The code in Example 5-80 is very straightforward. First, it retrieves the 
parameters given to the JSP. Then, it uses string manipulation to isolate the 
integer and the fractional part of the rating, adding appropriate rounding if 
necessary. Finally, it defines the text to display if the images cannot be 
displayed (for example, if the page is rendered by a screen reader). 

6. Complete the StarRating. jsp by adding the code in Example 5-81 to the end 
of the file. Press Ctrl+S to save the file. 

Example 5-81 The logic to generate the stars for StarRating.jsp 

<%-- First the full stars --%> 

<c:forEach var="index" begin="${lowerBound+l}" end="${rati nglnt} "><%-- 

--%><img src="${fullStar}" width="16" height="13" al t="${rati ngAl tText} " /><%— 

— %></c:forEach><%— 


Then the fraction part 
— %><c:choose><%-- 

--%><c:when test="${ratingFrac > 0} "><%— 

— %><img src="${fractionStarPrefix}${ rati ngFrac}${fractionStarSuf fix} " 
width="16" height="13" al t="${rati ngAl tText} " /><%-- 
...we "used" a star for the fraction, so display one less empty star... 
--%><c:set var="skip" value="2" /><%-- 
— %></c:when><%— 

— %><c : otherwi se><%-- 

--%><c:set var="skip" value="l" /><%— 

--%></ c : otherwi se><%-- 
— %></c:choose><%-- 

And finally the empty stars 

--%><c:forEach var="index" begin="${ratinglnt+skip}" end="${upperBound} "><%-- 

— %><img src="${emptyStar} " width="16" height="13" alt="${ratingAltText}" /><%-- 
--%></c:forEach> 


The code in Example 5-81 is the main logic, split into the following sections: 

► The code to generate the full stars, given by the integer part of the rating 

► The code to generate one optional fractional star 

► The code to fill up with empty stars 

Important: All HTML and JSTL tags in Example 5-81 are separated using 
JSP comments to ensure that all the <img> tags appear in the resulting HTML 
document without any spacing. Even a single white space character ruins the 
layout of the stars. 


The StarRating.jsp file is now complete. 
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5.5.6 Create the JSP fragment for the Write Review button 


As mentioned earlier, you introduce a JSP fragment that contains the display 
logic for generating a button that links to the Write Review page if the current 
user is a registered shopper or links to the sign in and log on pages if the current 
user is a guest shopper. 

To create this JSP snippet: 

1 . In the Package Explorer of IBM WebSphere Commerce V7 Developer Edition, 
expand and right-click Stores 0 WebContent 0 Madisons 0 mobile 0 
Snippets 0 Catalog and select New 0 Folder. 

2. The New Folder wizard opens. Enter Reviews in the Folder name field, and 
click Finish. 

3. Right-click the newly created folder, and select New 0 File. 

4. The New File wizard opens. Enter WriteReviewLink.jspf in the File name 
field, and click Finish. 

5. In the source code panel, enter the code from Example 5-82. This code 
defines the following URLs: 

- writeReviewLink 

This is the direct link to the write review page and is used when the JSP 
fragment is included on a page that is viewed by a registered shopper. 

- logonURL 

This is the link to the logon page. Notice that we specify the 
wri teRevi ewLi nk value as the URL parameter value to utilize the fact that 
the mobile logon page allows the user to be redirected back to a certain 
page after logging on. 

- registerllRL 

This is the link to the mobile registration page. Because this page does not 
support redirection back to a specific page, we specify only the common 
store parameters. 

Example 5-82 URL generation code for the EnterWriteReviewLink.jspf file 

<wcf:url var="writeReviewLink" val ue="mPostReviewsView"> 

<c:forEach var="parameter" items="${WCParamVal ues} "> 

<c:forEach var="value" items="${parameter.value}"> 

<wcf:param name="${parameter. key} " value="${value}" /> 
</c:forEach> 

</c:forEach> 

<wcf:param name="partNumber" val ue="${partNumber} " /> 

</wcf :url> 
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<wcf:url var="logonURL" val ue="Mobi 1 eLogonForm"> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 
<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 
<wcf:param name="l angld" val ue="${WCParam. 1 angld} " /> 
<wcf:param name="URL" value="${writeReviewLink}" /> 

</wcf :url> 

<wcf :url var="registerURL" val ue="Mobi lellserRegi strati onAddForm"> 
<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 
<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 
<wcf:param name="l angld" val ue="${WCParam. 1 angld} " /> 
<wcf:param name="regi ster_button" val ue="Register" /> 

</wcf :url> 


6. Add the code from Example 5-83 after the last line of code from 
Example 5-82. 

This code implements the display logic. The code simply uses the userType 
attribute defined in JSTLEnvironmentSetup. jspf to determine whether the 
current user is a registered shopper. If the user is not a registered shopper, 
links for registration display. Otherwise, a form with a single button is 
displayed for writing a review. 

Note: The form approach is mainly used to avoid any Web crawlers from 
accidentally generating reviews, although it is unlikely that such crawlers 
appear to the site as registered shoppers. 

7. Save the file by pressing Ctrl+S. 

Example 5-83 Display logic for the EnterWriteReviewLink.jspf file 
<c:choose> 

<c:when test="${userType eq ' G ' } "> 

<%— guest shopper -- show sign in or log on links --%> 
<fmt:message key="WRITE_REVIEW_REGISTER_OR_LOGIN" 
bundle="${storeText} "> 

<fmt:param val ue="${fn:escapeXml (regi sterURL) } " /> 

<fmt:param val ue="${fn:escapeXml (1 ogonURL) } " /> 
</fmt:message> 

</c:when> 

<c:otherwise> 

<%-- registered user, show Write Review button --%> 

<fmt:message var="writeReview" key="REVIEW_WRITE_REVIEW" 
bundle="${storeText}" /> 

<form method="get" action="mPostReviewsView"> 

<fieldset> 
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<c:forEach var="parameter" items="${WCParamVal ues} "> 
<c:forEach var="value" items="${parameter.value}"> 
<input type="hidden" name="${parameter.key} " 
value="${value}" /> 

</c:forEach> 

</c:forEach> 

<input type="hidden" name="partNumber" 
val ue="${partNumber} " /> 

<input type="submit" name="review" 
val ue="${writeReview} " /> 

</fieldset> 

</form> 

</c:otherwise> 

</c:choose> 


The Write Review button JSP fragment is now complete and can be included 
statically on all pages that need such a button. 


5.5.7 Create the JSP fragment for the review header 

Another JSP fragment that is needed on several pages is the review header, as 
shown in Figure 5-51 . The JSP fragment must be able to display the “Read 
review” link conditionally. 


"\E 


★ ★★★★ 

Fantastic chair! 

by: happyli on 8/25/09 
7:08PM 
» Read review 


Figure 5-5 1 Review header 


To create this JSP fragment: 

1 . In the Package Explorer of IBM WebSphere Commerce V7 Developer Edition, 
expand and right-click Stores 0 WebContent 0 Madisons 0 mobile 0 
Snippets 0 Catalog 0 Reviews and select New 0 File. 

2. The New File wizard opens. Enter ReviewHeadingDisplay.jspf in the File 
name field, and click Finish. 

3. In the source code panel, enter the code from Example 5-84, which defines 
three URLs. 

Example 5-84 Full source code for the ReviewHeadingDisplay.jspf file 
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This code can be statically included by any page that has 
instantiated an object of type ReviewsDataBean with the attribute ID 
reviewDetails. 

<a href="#" class="user_image"> 

<img src="/soccom/smal 1 . jpg" 
width="34" height="34" 

alt="${fn:escapeXml (reviewDetails. userid)}" /> 

</a> 

<ul> 

<1 i> 

<%out.fl ush() ;%> 

<c: import 

url ="${jspStoreDir}mobi le/Snippets/ReusableObjects/StarRating.jsp"> 
<c:param name="l owerBound" value="${reviews.lowerBound}" /> 
<c:param name="upperBound" value="${reviews.upperBound}" /> 
<c:param name="rating" val ue="${reviewDetai 1 s. rating} " /> 
</c:import> 

<%out.fl ush() ;%> 

</l i> 

<1 i><h4><c:out val ue="${reviewDetai 1 s . title}" /></h4></li> 

<1 i> 

<%-- retrieve date format and format the review date --%> 
<fmt:message var="dateFormat" key="REVIEW_DATEFORMAT" 
bundle="${storeText}" /> 

<fmt:message key="REVIEW_OVERVIEW_INFO" bundle="${storeText} "> 
<fmt:param value="${reviewDetails. userid}" /> 

<fmt : paramxfmt : f ormatDate pattern= " $ { dateFormat } " 
val ue="${reviewDetai 1 s.submissionTimeAsDate} " 

/></fmt:param> 

</fmt:message> 

</l i> 

<c:if test="${ lempty readReviewLink} "> 

<fmt:message var="readReview" key="REVIEW_READ_REVIEW" 
bundle="${storeText}" /> 

<1 i> 

<span class="bul let">&#187; </span> 

<a href="${fn:escapeXml (readReviewLink)} '/>" 
ti tl e="${fn :escapeXml (readRevi ew) } "> 

${readReview} 

</a> 

</l i> 

</c : i f > 

</ul> 


344 Building Multichannel Applications with WebSphere Commerce 



Important: In the review list, we display a static avatar image 
(/soccom/small .jpg) for the user profile picture. You can choose to display 
a dynamic picture that is retrieved from a social profile for the user. 


4. Save the file by pressing Ctrl+S. 

The ReviewHeadingDisplay.jspf JSP snippet is now complete. As the JSP 
comment in the top of Example 5-84 states, the snippet can by used as a static 
include by an including page that has already instantiated a ReviewsDataBean 
using the attribute revi ewDetai 1 s. 

5.5.8 Modify the product display pages 

As illustrated in Figure 5-42 on page 314, you need to amend the product page 
with the ability to show the overall rating for a product along with a link to the 
review details for that product. Because the product display page is in fact divided 
across four separate display pages, you need to create a JSP fragment that can 
be included from any of those pages to minimize code duplication across the four 
product display pages. We call this page RatingDisplay.jspf and place it in the 
WebContent\Madi sons\mobi 1 e\Sni ppets\Catal og\Catal ogEntryDi spl ay folder 
within the Stores project. 

In this section, we explain how to modify the product display pages in the 
following topics: 

► Create the RatingDisplay.jspf fragment 

► Modify the CachedProductDisplay.jsp file 

► Modify the CachedltemDisplay.jsp file 

► Modify the CachedBundleDisplay.jsp file 

► Modify the CachedPackageDisplay.jsp file 

In this example, we use the part number for the product ID that is displayed, 
which results in different review entries for a product and each of its SKUs. In 
your implementation, you might want to collate all the reviews for a number of 
SKUs under the parent product. 
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Create the RatingDisplay.jspf fragment 

To create this fragment: 

1 . In the Java EE perspective of IBM WebSphere Commerce V7 Developer 
Edition, expand and right-click Stores 0 WebContent 0 Madisons 0 
mobile 0 Snippets 0 Catalog 0 Reviews and select New 0 File. 

2. In the New File wizard, enter RatingDisplay.jspf in the File name entry field. 
Ensure that the parent folder entry field contains the following path: 
Stores/WebContent/Madi sons/mobi 1 e/Sni ppets/Revi ews/Catal ogEntryDi spl ay 
Click Finish. 

3. The JSP editor opens. Enter the code from Example 5-85, and then press 
Ctrl+S to save the file. 

Example 5-85 Code for RatingDisplay.jspf to retrieve the ratings details 
<%-- BEGIN overall rating code --%> 

<wcbase : useBean i d="revi ewCatentry " 

cl assname="com. i bm. commerce . catal og . beans . Catal ogEntryDataBean" 
scope="request" /> 

<c:set var="reviewltem" val ue="${reviewCatentry.partNumber} " /> 

<%-- instantiate the review smart data bean to retrieve the review details --%> 
<wcbase:useBean id="reviews" 

cl assname="com. i bm. i tso . commerce . soccom. beans . Revi ewsDataBean" 
scope="request"> 

<c:set property="pageSize" value="l" target="${reviews} " /> 

<c:set property="onPage" value="l" target="${reviews} " /> 

<c:set property="sortOptions" value="rating|desc" target="${reviews} " /> 

<c:set property="partNumber" val ue="${reviewltem} " target="${reviews} " /> 
</wcbase:useBean> 


The code in Example 5-85 retrieves the review information for the current 
product, item, bundle, or package. It instantiates a Catal ogEntryDataBean 
using the request information in order to retrieve the part number of the 
current catalog entry. Then, an instance of the Revi ewsDataBean class is 
created and populated using the parameters relevant to this page. 

Because we are interested only in overview information and because the 
overview information is the same regardless of the number of reviews that we 
retrieve, we ask to retrieve only a single review by specifying a page size of 1. 
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4. Add the code in Example 5-86 at the end of RatingsDisplay.jspf, and press 
Ctrl+S to save the file. 

Example 5-86 Link information initialization code 

<%-- prepare the link text for the review details --%> 

<fmt :message var="readRevi ewsLi nkTi tl e" 

key = " RAT I NG_READ_REV I EWS_L INK" bundl e="${storeText} " /> 

<%-- prepare the link target for the review details --%> 

<wcf:url var="readReviewsLink" val ue="mProductReviewsView"> 

<c:forEach var="parameter" items="${WCParamVal ues} "> 

<c:forEach var="value" items="${parameter.value}"> 

<wcf:param name="$ {parameter. key} " value="${value}" /> 

</c:forEach> 

</c:forEach> 

<wcf:param name="pgGrp" val ue="${WCParam.pgGrp} " /> 

<wcf:param name="onPage" value="l" /> 

<wcf:param name="sortOptions" value="rating|desc"/> 

</wcf :url> 

<%-- prepare the link text for writing a review --%> 

<fmt :message var="wri teRevi ewLi nkTi tl e" 

key="RATING_WRITE_FIRST_REVIEW_LINK" bundl e="${storeText} " /> 


The code in Example 5-86 prepares the text and URL for reading the reviews. 
Now that everything is initialized, you can add the main logic to 
RatingDisplay.jspf. 

5. Add the code in Example 5-87 to the end of RatingDisplay.jspf, and press 
Ctrl+S to save the file. 

Example 5-87 Main logic for RatingDisplay.jspf 
<ul id="product_rating"> 

<c:choose> 

<%-- an error occurred retrieving the review information --%> 

<c:when test="$ {reviews. error} "> 

<1 i><fmt:message key=''RATING_OVERALL_ERROR" bundl e="${storeText} " /></li> 
<li><span class="bul let">&#187; </span> 

<a href="${readReviewsLink}" 

ti tl e="<c : out val ue= 1 ${ readRevi ewsLi nkTi tl e} ' />"> 

<c:out val ue="${ readRevi ewsLi nkTi tie} "/> 

</a> 

</l i> 

</c:when> 

<%-- no reviews yet --%> 
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<c:when test="${reviews .numOfOveral 1 Rati ngs eq 0}"> 

<1 i><fmt:message key="RATING_OVERALL_NONE" bundl e="${storeText} " /></li> 

<1 i ><%@i ncl ude 

f i 1 e= . ./Snippets/Catalog/Reviews/WriteReviewLink.jspf" %></l i> 
</c:when> 

<%-- one or more reviews --%> 

<c:otherwise> 

<1 i><fmt:message key="RATING_OVERALL_TITLE" bundl e="${storeText} " /> 
<%out.fl ush() ;%> 

<c: import 

url ="${ jspStoreDi rjmobi 1 e/Sni ppets/Reusabl eObjects/StarRati ng . jsp"> 
<c:param name="l owerBound" value="${reviews.lowerBound}" /> 

<c:param name="upperBound" value="${reviews.upperBound}" /> 

<c:param name="avgOveral 1 Rati ng" val ue="${reviews .avgOveral 1 Rati ng} " /> 
</c:import> 

<%out.fl ush() ;%> 

</l i> 

<1 i ><%@i ncl ude 

f i 1 e= . ./Snippets/Catalog/Reviews/WriteReviewLink.jspf" %></l i> 
</c:otherwise> 

</c:choose> 

</ul> 

<%-- END overall rating code --%> 


The code in Example 5-87 creates one of the following occurrences: 

- An error message if an error occurred while attempting to retrieve the 
ratings 

- A link to the Write a Review page if no ratings were found for the product 

- The overall average rating with a link to the review details if one or more 
reviews were found 

The RatingDisplay.jspf fragment is now complete. 

Modify the CachedProductDisplay.jsp file 

To add a rating overview to the CachedProductDisplay.jsp file: 

1 . In the Java EE perspective of IBM WebSphere Commerce V7 Developer 
Edition, expand and double-click Stores 0 WebContent 0 Madisons 0 
mobile 0 Snippets 0 Catalog 0 CatalogEntryDisplay 0 
CachedProductDisplay.jsp. 

2. The CachedProductDisplay.jsp file opens in the JSP editor. If the source tab 
is not active, then switch to it by clicking Source in the bottom-left of the 
panel. 
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3. Press Ctrl+F to open the Find/Replace window, enter AddToProdCompare in the 
Find entry field, and click Find. 

The code snippet shown in Example 5-88 is displayed. 

Example 5-88 Code snippet from CachedProductDisplay.jsp 

<p><span class="bul let">&#187; </span> <a href="#" 
onclick="javascript:resolveSKU('<c:out val ue="${itemsAttributes} " />', '<c:out 
val ue="${sel Val Separator} " />');" ti tl e="${fn:escapeXml (showStoreAvai 1 ) } "><c:out 
value="${showStoreAvail }" /></a></p> 

</c:if> 

<wcf:url var="AddToProdCompare" val ue="mAddToProdCompare"> 

<c:forEach var="parameter" items="${WCParamVal ues} "> 

<c:forEach var="value" items="${parameter.value}"> 


4. Insert the following line between the </c : i f> and the <wcf : url > lines in 
Figure 5-88. Then, press Ctrl+S to save the file. 

<%@ include file=". ./Reviews/RatingDisplay.jspf" %> 

The resulting code should be similar to the code shown in Example 5-89 with 
the inserted code highlighted in bold font. 

Example 5-89 Code snippet from CachedProductDisplay.jsp with rating added 

<p><span class="bul let">&#187; </span> <a href="#" 
onclick="javascript:resolveSKU('<c:out value="${itemsAttributes}" />', '<c:out 
val ue="${sel Val Separator} " />');" ti tl e="${fn:escapeXml (showStoreAvai 1 ) } "><c:out 
value="${showStoreAvail }" /></a></p> 

</c:if> 

<%@ include file=". ./Reviews/RatingDisplay.jspf" %> 

<wcf:url var="AddToProdCompare" val ue="mAddToProdCompare"> 

<c:forEach var="parameter" items="${WCParamVal ues} "> 

<c:forEach var="value" items="${parameter.value}"> 
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Modify the CachedltemDisplay.jsp file 

To add the rating overview to the CachedltemDisplay.jsp file: 

1 . In the Java EE perspective of IBM WebSphere Commerce V7 Developer 
Edition, expand and double-click Stores 0 WebContent 0 Madisons 0 
mobile 0 Snippets 0 Catalog 0 CatalogEntryDisplay 0 
CachedltemDisplay.jsp. 

2. The CachedltemDisplay.jsp file opens in the JSP editor. If the source tab is 
not active, then switch to it by clicking Source in the bottom-left of the panel. 

3. Press Ctrl+F to open the Find/Replace window, enter Wi shl i stDi spl ayURL in 
the Find entry field, and click Find. 

The code snippet shown in Example 5-90 is displayed. 

Example 5-90 Code snippet from CachedltemDisplay.jsp 
</c:import> 

</li> 


<c:if test="${isBuyable}"> 

<c:set var="Wishl i stDi spl ayURL" 

val ue=" Interest I temDi spl ay?URL=mInterestLi stDi spl ay&l i stld= . " /> 
<wcf:url var="AddToWishl ist" val ue="InterestItemAdd"> 

<wcf:param name="catEntryId" value="${item.itemID}"/> 


4. Insert the following line between the </l i> and the <c:if> lines in 
Example 5-90, and press Ctrl+S to save the file: 

<%@ include file=". ./Reviews/RatingDisplay.jspf" %> 

The resulting code should be similar to the code shown in Example 5-91 with 
the inserted code highlighted in bold font. 

Example 5-91 Code snippet from CachedltemDisplay.jsp with rating added 

</c:import> 

</li> 

<%@ include file=". ./Reviews/RatingDisplay.jspf" %> 

<c:if test="${isBuyable}"> 

<c:set var="Wishl i stDi spl ayURL" 

val ue=" Interest ItemDi spl ay?URL=mInterestLi stDi spl ay&l i stld= . " /> 

<wcf:url var="AddToWishl ist" val ue="InterestItemAdd"> 

<wcf:param name="catEntry!d" value="${item.itemID}"/> 
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Modify the CachedBundleDisplay.jsp file 

To add the rating overview to the CachedBundleDisplay.jsp file: 

1 . In the Java EE perspective of IBM WebSphere Commerce V7 Developer 
Edition, expand and double-click Stores 0 WebContent 0 Madisons 0 
mobile 0 Snippets 0 Catalog 0 CatalogEntryDisplay 0 
CachedBundleDisplay.jsp. 

2. The CachedBundl eDi spl ay . jsp file opens in the JSP editor. If the source tab is 
not active, then switch to it by clicking Source in the bottom-left of the panel. 

3. Press Ctrl+F to open the Find/Replace window, enter submitAddToCart() in 
the Find entry field, and click Find. 

The code snippet shown in Example 5-92 is displayed. 

Example 5-92 Code snippet from CachedBundleDisplay.jsp 
<1 i> 

<input type="button" oncl i ck="javascri pt :submi tAddToCart() ; " name="add_to_cart" 
id="add_to_cart" val ue="<fmt:message key="ADD_TO_CART" bundl e="${storeText} " />" /> 
</l i> 

<1 i> 

<span class="bullet">&#187; </span> 


4. Insert the following line between the </1.1> and the <1 i> lines in 
Example 5-92, and press Ctrl+S to save the file: 

<%@ include file=". ./Reviews/RatingDisplay.jspf" %> 

The resulting code should be similar to the code shown in Example 5-93 with 
the inserted code highlighted in bold. 

Example 5-93 Code snippet from CachedBundleDisplay.jsp with rating added 
<1 i> 

<input type="button" oncl ick="javascript:submitAddToCart() name="add_to_cart" 
id="add_to_cart" val ue="<fmt:message key="ADD_TO_CART" bundl e="${storeText} " />" /> 
</li> 

<%@ include file=". ./Reviews/RatingDisplay.jspf" %> 

<1 i> 

<span class="bullet">&#187; </span> 
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Modify the CachedPackageDisplay.jsp file 

To add the rating overview to the CachedPackageDisplay.jsp file: 

1 . In the Java EE perspective of IBM WebSphere Commerce V7 Developer 
Edition, expand and double-click Stores 0 WebContent 0 Madisons 0 
mobile 0 Snippets 0 Catalog 0 CatalogEntryDisplay 0 
CachedPackageDisplay.jsp. 

2. The CachedPackageDisplay.jsp file opens in the JSP editor. If the source tab 
is not active, then switch to it by clicking Source in the bottom-left of the 
panel. 

3. Press Ctrl+F to open the Find/Replace window, enter submitAddToCart() in 
the Find entry field, and click Find. 

The code snippet shown in Example 5-94 is displayed. 

Example 5-94 Code snippet from CachedPackageDisplay.jsp 

<input type="button" oncl i ck="javascri pt :submi tAddToCart() ; " name="add_to_cart" 
id="add_to_cart" val ue="<fmt:message key="ADD_TO_CART" bundl e="${storeText} " />" /> 

<1 i> 

<span class="bullet">&#187; </span> 

<a href="#" oncl ick= "document. getElementBy Id ( 'wishl i st_add ' ) .submi t() 
title="<fmt:message key="WISHLIST" bundl e="${storeText} " />"><fmt:message 
key="WISHLIST" bundl e="${storeText} " /></a> 

</l i> 


4. Insert the following line between the <i nput> and the <1 i > lines in 
Example 5-94, and press Ctrl+S to save the file. 

<%@ include file=". ./Reviews/RatingDisplay.jspf" %> 

The resulting code should be similar to the code shown in Example 5-95 with 
the inserted code highlighted in bold font. 

Example 5-95 Code snippet from CachedPackageDisplay.jsp with rating added 

<input type="button" oncl i ck="javascri pt :submi tAddToCart() ; " name="add_to_cart" 
id="add_to_cart" val ue="<fmt:message key="ADD_TO_CART" bundl e="${storeText} " />" /> 

<%@ include file=". ./Reviews/RatingDisplay.jspf" %> 

<1 i> 

<span class="bullet">&#187; </span> 

<a href="#" oncl ick= "document. getElementBy Id ( 'wishl i st_add 1 ) . submi t () 
title="<fmt:message key="WISHLIST" bundl e="${storeText} " />"><fmt:message 
key="WISHLIST" bundl e="${storeText} " /></a> 

</li> 
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5.5.9 Modify the product compare page 


As mentioned earlier, one of the major factors behind a shopper’s buying 
decision on the product compare page is the relative product ratings of the 
products that are compared. You add the overall rating to the product compare 
page between the price and the inventory availability sections, as shown in 
Figure 5-43 on page 315. The product compare page is generated by the 
ProductCompareResultGridDisplay.jsp file, so you need to modify this JSP to 
add the ratings. 

To amend the product compare page with overall product ratings: 

1 . In the Java EE perspective of IBM WebSphere Commerce V7 Developer 
Edition, expand and double-click Stores 0 WebContent 0 Madisons 0 
mobile 0 ShoppingArea 0 CatalogSection 0 CatalogEntrySubsection 0 
ProductCompareResuItGridDisplay.jsp. 

2. The ProductCompareResul tGridDispl ay. jsp file opens in the JSP editor. If 
the source tab is not active, then switch to it by clicking Source in the 
bottom-left of the panel. 

3. Press Ctrl+F to open the Find/Replace window, enter online_avai lability in 
the Find entry field, and click Find. 

4. The code shown in Example 5-96 is displayed. This example is the part of the 
code between the price display and the availability display on the product 
compare page. 

Example 5-96 Division between price display and the availability display in product compare 

<di v cl ass="cl ear_f 1 oat"></di v> 

</di v> 

</di v> 

<div id="onl ineavailabil ity"> 

<div class="grid_row compare_criteria"> 


5. Add the code in Example 5-97 before the highlighted line in Example 5-96, for 
example between the end of the previous <di v> tag and the beginning of the 
<di v> tag with the ID of onl i ne_avai 1 abi 1 i ty. 

Example 5-97 Overall rating display for product compare 
<%-- BEGIN: Rating and Reviews --%> 

<fmt:message var="readReviewsLinkTitle" key="RATING_READ_REVIEWS_LINK" 
bundle="${storeText} " /> 

<div id="overal l_review"> 

<div class="grid_row compare_criteria"> 

<div class="grid_column"> 


Chapter 5. Mobile commerce features in WebSphere Commerce V7 353 



<di v cl ass="gri d_col umn_paddi ng"> 

<span class="bold"> 

<fmt:message key="PROD_CMPR_RATING" bundl e="${storeText} "/> 

</span> 

</di v> 

</di v> 

<di v cl ass="cl ear_f 1 oat"></di v> 

</di v> 

<div class="grid_row"> 

<c:forEach var="catEntry" items="${requestScope.catEntryObjs} " 
varStatus="counter"> 

<c: remove var=" reviews" /> 

<c: remove var="readReviewsLink" /> 

<wcf:url var="readReviewsLink" val ue="mProductReviewsView"> 

<wcf:param name="onPage" value="l" /> 

<wcf:param name="sortOptions" value="rating|desc"/> 

<wcf :param name= "product Id" val ue="$ {cat Entry. catalog Entry ID} "/> 
<wcf:param name="pgGrp" val ue="prodComp"/> 

</wcf :url> 

<wcbase:useBean id="reviews" 

cl assname="com. i bm. i tso . commerce . soccom. beans . Revi ewsDataBean"> 

<c:set property="pageSize" value="l" target="${reviews} " /> 

<c:set property="onPage" value="l" target="${reviews} " /> 

<c:set property="sortOptions" val ue="rati ng | desc" target="${reviews} " /> 
<c:set property="partNumber" val ue="${catEntry.partNumber} " 
target="${reviews} " /> 

</wcbase:useBean> 

<div class="grid_col umn"> 

<%out.fl ush() ;%> 

<c: import 

url ="${ jspStoreDi rjmobi 1 e/Sni ppets/Reusabl eObjects/StarRati ng . jsp"> 
<c:param name="l owerBound" value="${reviews.lowerBound}" /> 

<c:param name="upperBound" value="${reviews.upperBound}" /> 

<c:param name="rating" val ue="${reviews.avgOveral 1 Rati ng} " /> 
</c:import> 

<%out.fl ush() ;%> 

<c:choose> 

<c:when test="${reviews .numOfOveral 1 Rati ngs eq 0}"> 

<fmt:message key="PROD_CMPR_RATING_NONE" bundl e="${storeText} " /> 
</c:when> 

<c:when test="${reviews .numOfOveral 1 Rati ngs eq 1}"> 

<a href="${fn:escapeXml (readReviewsLink)}" 

ti tl e="$ { f n :escapeXml (readRevi ewsLi nkTi tl e) } ' />"> 

<fmt:message key="PROD_CMPR_RATING_ONE" bundle="${storeText} " /> 
</a> 
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</c:when> 

<c:otherwise> 

<a href="${fn:escapeXml (readReviewsLink)}" 

title="${fn:escapeXml (readReviewsLinkTitle) } "> 

<fmt message key="PROD_CMPR_RATING_MULTIPLE" 
bundle="${storeText} "> 

<fmt:param value="${reviews.numOfOverall Ratings}" /> 
</fmt:message> 

</a> 

</c:otherwise> 

</c:choose> 

</di v> 

</c:forEach> 

<di v cl ass="cl ear_f 1 oat"></di v> 

</di v> 

</di v> 

<%-- END: Rating and Reviews --%> 


6. Save and close the file. 

The code in Example 5-97 creates a new row in the product compare grid with 
columns for each of the products in the product comparison. Each product shows 
either a static text of “no reviews” or the rating with a link to the reviews. There 
are two special cases that support different localization strings in the case of only 
one review or more than one review. 

5.5.10 Create the JSP for the review list and overview 

You create the ProductReviewList.jsp file to display the list of reviews for a 
product and to enable the user to sort products based on the rating or the 
submission time and to paginate between the multiple review pages for a 
product. 

To create the review list JSP, ProductReviewList.jsp: 

1 . In the Package Explorer of IBM WebSphere Commerce V7 Developer Edition, 
expand and right-click Stores 0 WebContent 0 Madisons 0 mobile 0 
ShoppingArea 0 CatalogSection and select New 0 Folder. 

2. The New Folder wizard opens. Enter ReviewSubsection in the Folder name 
field, and click Finish. 

3. Right-click the newly created folder, and select New 0 File. 

4. The New File wizard opens. Enter ProductReviewList.jsp in the File name 
field, and click Finish. 
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5. Next, add a comment to introduce the use of JSP, declare the JSTL tags to be 
used and define a few constants. In the JSP editor, enter the skeleton HTML 
document code shown in Example 5-98, and press Ctrl+S to save the file. 

We expand sections of this code in the following steps. 


Example 5-98 Skeleton code for ProductReviewList.jsp 



* This JSP displays the product review list. 


<!-- BEGIN ProductReviewList.jsp --> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/fmt" prefix="fmt" %> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/functions" prefix="fn" %> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/core" prefix="c" %> 

<%@ taglib uri="http://commerce. ibm.com/base" prefix="wcbase" %> 

<%@ taglib uri="http://commerce. ibm.com/foundation" prefix="wcf" %> 

<%@ include file=" ../../../. ./incl ude/parameters . jspf " %> 

<%@ include file=" ../../. ./incl ude/JSTLEnvi ronmentSetup. jspf" %> 

<%— 1: Initialize beans and URL links --%> 

<! DOCTYPE html PUBLIC "-//WAPFORUM//DTD XHTML Mobile 1.2//EN" 
"http://www.openmobi leal liance.org/tech/DTD/xhtml -mobi lel2.dtd"> 

<html xml ns=" http: //www. w3.org/ 1999/xhtml " 1 ang="${shortLocal e} " 
xml :lang="${shortLocale}"> 

<head> 

<title> 

<fmt:message key="REVIEW_LIST_TITLE" bundl e="${storeText} " />: 

<c:out val ue="${catal ogEntry. descript ion. name} " escapeXml ="fal se"/> 

</t i t 1 e> 

<meta http-equiv="content-type" content="application/xhtml+xml" /> 

<meta http-equi v="cache-control " content="max-age=300" /> 

<meta name="viewport" 

content="width=device-width, initial-scale=1.0, user-seal able=no" /> 
<1 i nk type="text/css" rel="stylesheet" href="${cssPath} "/> 

</head> 

<body> 

<div id="wrapper"> 
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<%@ include fi 1 e=" ./incl ude/HeaderDi spl ay .jspf" %> 

<%@ incl ude fi 1 e=" ./incl ude/BreadCrumbTrai 1 Di spl ay . jspf"%> 

<%out.fl ush() ;%> 

<div id="reviews" cl ass="content_box"> 

<di v cl ass="headi ng_contai ner"> 

<h2><fmt:message key="REVIEW_LIST_TITLE" bundl e="${storeText} " /></h2> 
<di v cl ass="cl ear_f 1 oat"></di v> 

</di v> 

<%-- 2. Main content --%> 

</di v> 

<%out.fl ush() ;%> 

<%@ include fi 1 e=" ./incl ude/FooterDi spl ay .jspf " %> 

</di v> 

</body> 

</html> 

<!-- END ProductReviewList.jsp --> 


6. Now, add the initialization code shown in Example 5-99 after the following 
line: 


<%-- 1: Initialize beans and URL links --%> 

The code first initializes variables used for the breadcrumb display JSP 
fragment and instantiates a Catal ogEntryDataBean to retrieve the part number 
for the product in question. It then instantiates and populates an instance of 
the ReviewsDataBean to retrieve the reviews for that product. 

The pageSize property can be loaded from a properties file, but in our 
example, we hard-coded the value to five results per page. 

The onPage property is used for current page number, and the sortOptions 
property is used for specifying the sorting field and direction. These values 
are available in the request for the JSP. 

Finally, a link to the product display page is generated for use later on in the 
page. 

Example 5-99 Initialization code for ProductReviewList.jsp 

<c:set var="pgGrp" value="${WCParam.pgGrp}" /> 

<c:choose> 

<c:when test= ' ${pgGrp == "prodComp"} '> 
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<c:set var="prodComparePageGroup" value="true" scope="request"/> 

</c:when> 

<c:when test= 1 $ { pgGrp == "search"} ’> 

<c:set var="searchPageGroup" value="true" scope="request"/> 

</c:when> 

<c:when test= 1 $ { pgGrp == "wishl ist"} ’> 

<c:set var="wishl i stPageGroup" value="true" scope="request"/> 

</c:when> 

<c:otherwise> 

<c:set var="categoryNavPageGroup" value="true" scope="request"/> 

</c:otherwise> 

</c:choose> 

<c:set var="productReviewPage" value="true" scope="request"/> 

<c:set var="productReviewListPage" val ue="true" scope="request"/> 

<wcbase:useBean id="catalogEntry" 

cl assname="com. i bm. commerce . catal og . beans . Catal ogEntryDataBean" /> 

<c:set var="partNumber" value="${catalogEntry.partNumber}" /> 

<wcbase:useBean id="reviews" 

cl assname= "com. ibm. i tso. commerce. soccom. beans. ReviewsDataBean"> 

<c:set property="pageSize" value="3" target="${reviews} "/> 

<c:set property="onPage" val ue="${WCParam.onPage} " target="${reviews} "/> 

<c:set property="sortOptions" value="${WCParam.sortOptions}" target="${reviews}"/> 
<c:set property="partNumber" val ue="${partNumber} " target="${reviews} "/> 
</wcbase:useBean> 

<wcf :url var="productDi spl ayLi nk" val ue="mProductDi spl ayVi ew"> 

<c:forEach var="parameter" items="${WCParamVal ues} "> 

<c:forEach var="value" items="${parameter.value}"> 

<c:if test="${parameter.key != 'reviewld' }"> 

<wcf:param name="${parameter. key} " value="${value}" /> 

</c : i f > 

</c:forEach> 

</c:forEach> 

</wcf :url> 
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7. Add the code shown in Example 5-100 after the following line: 

<%-- 2. Main content --%> 

This code implements the following logic to display the overall star rating and 
Write Review link: 

a. Checks whether the data bean returns error. If there is a error, displays the 
message. This message can be picked from the properties file that was 
created in “Define localized strings for pages” on page 397. 

b. Writes the code to display the product name if there is no error. 

c. Imports the StarRating. jsp file to display the star rating for the product. 
Passes the 1 owerBound, upperBound, and avgOveral 1 Rati ng parameters to 
this JSP. The value for these parameters is retrieved from the 
ReviewsDataBean that was instantiated in step 6 on page 357. 

d. Checks whether the user is logged in or is a guest user. If the user is 
logged in, adds a link to Write Review. If not, then presents the user a 
message to Register or Signln to write a review. 

Example 5- 1 00 Overall star rating and Write Review link 
<c:choose> 

<c:when test="$ {reviews. error} "> 

<p><fmt:message key = " RAT I NG_0V ERALL_ERROR" bundl e="${storeText} " /></p> 
</c:when> 

<c:otherwise> 

<p> 

<a href="${fn:escapeXml (productDisplayLink)}"> 

<c:out value="${catalogEntry. description. name}" /> 

</a> 

</p> 

<p><fmt:message key="RATING_OVERALL_TITLE" bundl e="${storeText} " /> 

<%out.fl ush() ;%> 

<c : import url ="${ jspStoreDi rjmobi 1 e/Sni ppets/Reusabl eObjects/StarRati ng . jsp"> 
<c:param name="l owerBound" value="${reviews.lowerBound}" /> 

<c:param name="upperBound" value="${reviews. upperBound}" /> 

<c:param name="rating" val ue="${reviews. avgOveral 1 Rati ng} " /> 

</c:import> 

<%out.fl ush() ;%> 

</p> 

<%@incl ude f i 1 e= . ./Snippets/Catalog/Reviews/WriteReviewLink.jspf" %> 
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8. Implement the sorting control as given in Example 5-101 . Add this code after 
the code from Example 5-100 on page 359. 

Example 5-101 Sorting control 
<div class="sort_by_control "> 

<fmt:message key="REVIEW_LIST_SORT_BY" bundl e="${storeText} " /> 

<c:choose> 

<c:when test="${empty WCParam.sortOptions | | 

f n : startsWi th (WCParam.sortOptions , ' rati ng ' ) } "> 

<wcf :url var="ProductReviewListSortURL" val ue="mProductReviewsView"> 
<c:forEach var="parameter" items="${WCParamValues}"> 

<c:if test="${parameter.key != 1 sortOptions ' }"> 

<c:forEach var="value" items="${parameter.value}"> 

<wcf:param name="${parameter. key} " value="${value}" /> 
</c:forEach> 

</c : i f > 

</c:forEach> 

<wcf:param name="sortOptions" value="submissionTime|desc" /> 

</wcf :url> 

<span class="current_sort"> 

<fmt: mess age key = " REV I EW_LI ST_SORT_BY_RAT I NG " bundl e="${storeText} " /> 
</span> 

<a href="${fn:escapeXml (ProductReviewListSortURL)}"> 

<fmt:message key = " REV I EW_LI ST_SORT_BY_NEWEST " bundl e="${storeText} " /> 
</a> 

</c:when> 

<c:otherwise> 

<wcf :url var="ProductReviewListSortURL" val ue="mProductReviewsView"> 
<c:forEach var="parameter" items="${WCParamVal ues} "> 

<c:if test="${parameter.key != 'sortOptions' }"> 

<c:forEach var="value" items="${parameter.value}"> 

<wcf:param name="${parameter. key} " value="${value}" /> 
</c:forEach> 

</ c : i f > 

</c:forEach> 

<wcf:param name="sortOptions" value="rating|desc" /> 

</wcf :url> 

<a href="${fn:escapeXml (ProductReviewListSortURL)}"> 

<fmt:message key = " REV I EW_LI ST_SORT_BY_RAT I NG " bundl e="${storeText} " /> 
</a> 

<span class="current_sort"> 

<fmt:message key = " REV I EW_LI ST_SORT_BY_NEWEST " bundl e="${storeText} " /> 
</span> 

</c:otherwise> 

</c:choose> 

</di v> 
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9. Write the code to display the list of reviews. Implement this code as shown in 
Example 5-102. Add the code after the code from Example 5-101 on 
page 360. 

Example 5- 1 02 List of reviews 
<ol class="l ist_reviews"> 

<c:forEach var="reviewDet" items="${reviews.reviewDetailsMap}" varStatus="status"> 
<c:set var="reviewDetails" val ue="${reviewDet.val ue} " /> 

<wcf:url var="readReviewLink" value="mReviewDetails"> 

<c:forEach var="parameter" items="${WCParamVal ues} "> 

<c:forEach var="value" items="${parameter.value}"> 

<wcf:param name="${parameter. key} " value="${value}" /> 

</c:forEach> 

</c:forEach> 

<wcf :param name="reviewld" val ue="${reviewDet.val ue.reviewld} "/> 

</wcf :url> 

<1 i> 

<%@include 

f i 1 e=" . /Sni ppets/Catal og/Revi ews/Revi ewHeadi ngDi spl ay . jspf " %> 

</li> 

</c:forEach> 


10. Implement the Pagination Control as given in Example 5-103. Add this code 
after the code from Example 5-102 on page 361 . 

Example 5- 1 03 Pagination control code 
<div class="paging_control "> 

<wcf :url var="ProductReviewListPrevURL" val ue="mProductReviewsView"> 

<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

<wcf:param name="productId" val ue="${WCParam.productId} " /> 

<wcf:param name="onPage" value="${reviews.pageNum - 1}" /> 

<wcf :param name="sortOptions" val ue="${WCParam.sortOpt ions} "/> 

<wcf:param name="pgGrp" val ue="${WCParam.pgGrp} " /> 

<c:if test="${ lempty WCParam.pgGrp} "> 

<c:choose> 

<c:when test="${WCParam.pgGrp == 'catNav'}"> 

<wcf:param name="categoryId" val ue="${WCParam.categoryId} " /> 

<wcf : param name= " parent_category_rn " 
val ue="${WCParam.parent_category_rn} " /> 

<wcf:param name="top_category" val ue="${WCParam.top_category} " /> 
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<wcf:param name="sequence" val ue="${WCParam. sequence} " /> 
</c:when> 

<c:when test="${WCParam.pgGrp == 'search' }"> 

<wcf :param name="resultCatEntryType" 
val ue="${WCParam.resultCatEntryType} " /> 

<wcf:param name="pageSize" val ue="${WCParam.pageSize} " /> 
<wcf:param name="searchTerm" val ue="${WCParam.searchTerm} " /> 
<wcf:param name="begi nlndex" val ue="${WCParam.beginIndex} " /> 
<wcf:param name="sType" val ue="${WCParam.sType} " /> 

</c:when> 

</c:choose> 

</c:if> 

</wcf :url> 

<wcf :url var="ProductReviewListNextURL" val ue="mProductReviewsView"> 
<wcf:param name="l angld" value="${langld}" /> 

<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 

<wcf:param name="productId" val ue="${WCParam.productId} " /> 

<wcf:param name="onPage" value="${reviews.pageNum + 1}" /> 

<wcf :param name="sortOptions" val ue="${WCParam.sortOpt ions} "/> 

<wcf:param name="pgGrp" val ue="${WCParam.pgGrp} " /> 

<c:if test="${ lempty WCParam.pgGrp} "> 

<c:choose> 

<c:when test="${WCParam.pgGrp == 'catNav'}"> 

<wcf:param name="categoryId" val ue="${WCParam.categoryId} " /> 

<wcf : param name= " parent_category_rn " 
val ue="${WCParam.parent_category_rn} " /> 

<wcf:param name="top_category" val ue="${WCParam.top_category} " /> 
<wcf:param name="sequence" val ue="${WCParam. sequence} " /> 
</c:when> 

<c:when test="${WCParam.pgGrp == 'search' }"> 

<wcf: param name="resultCatEntryType" 
val ue="${WCParam.resultCatEntryType} " /> 

<wcf:param name="pageSize" val ue="${WCParam.pageSize} " /> 
<wcf:param name="searchTerm" val ue="${WCParam.searchTerm} " /> 
<wcf:param name="begi nlndex" val ue="${WCParam.beginIndex} " /> 
<wcf:param name="sType" val ue="${WCParam.sType} " /> 

</c:when> 

</c:choose> 

</c:if> 

</wcf :url> 

<div class="page_number"> 

<fmt:message key="REVIEW_LIST_PAGE" bundl e="${storeText} "> 

<fmt:param value="${reviews.pageNum}" /> 
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<fmt:param val ue="${reviews .noOfTotal Pages} " /> 

</fmt:message> 

</di v> 

<c:if test="${reviews. noOfTotal Pages > 1}"> 

<c:if test="${reviews.pageNum > 1}"> 

<span class="bullet">&#171; </span> 

<fmt:message var="prevTitle" key="REVIEW_LIST_PAGE_PREV_TITLE" 
bundle="${storeText}" /> 

<a href="${fn:escapeXml (ProductReviewListPrevURL)}" 
title="${fn:escapeXml (prevTitle) }"> 

<fmt:message key="REVIEW_LIST_PAGE_PREV" bundl e="${storeText} " /> 
</a> 

</c:if> 

<c:if test="${reviews.pageNum < revi ews. noOfTotal Pages} "> 

<c:if test="${reviews. noOfTotal Pages > 1}"> 

&nbsp; 

</c : i f > 

<fmt:message var="nextTitle" key="REVIEW_LIST_PAGE_NEXT_TITLE" 
bundl e="${storeText}" /> 

<a href="${fn:escapeXml (ProductReviewListNextURL)}" 
title="${fn:escapeXml (nextTitle) }"> 

<fmt: mess age key = " REVI EW_LI ST_PAGE_N EXT" bundl e="${storeText} " /> 
</a> 

<span class="bullet"> &#187;</span> 

</c:if> 

</c:if> 

</di v> 

</c:otherwise> 

</c:choose> 


You cannot modify this view until you complete the steps in 5.5.14, “Modify 
infrastructure resources” on page 384. 


5.5.1 1 Create a page for review details 

In this section, we explain how to create the JSP to shows the review details. You 
will implement access control, struts configuration, and text bundle configuration 
at a later stage. Refer to 5.5.14, “Modify infrastructure resources” on page 384 
for information about how to configure these files. 
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To create the ProductReviewDetails.jsp file: 

1 . In the Java EE perspective of IBM WebSphere Commerce V7 Developer 
Edition, expand and right-click Stores 0 WebContent 0 Madisons 0 
mobile 0 ShoppingArea 0 CatalogSection 0 ReviewSubsection, and 
then select New 0 File. 

2. The New File wizard opens. Enter ProductReviewDetails.jsp in the File 
name entry field. Then, ensure that the parent folder entry field contains the 
following path: 

Stores/WebContent/Madi sons/mobi 1 e/Shoppi ngArea/Catal ogSecti on/Revi ew 

Subsection 

Click Finish. 

3. The newly created ProductReviewDetails.jsp file opens in the source file 
editor. Enter the skeleton code shown in Example 5-104, and save the file by 
pressing Ctrl+S. 

Example 5- 1 04 Skeleton for ProductReviewDetails.jsp 


* This JSP displays the product review details for a given product 


<!-- BEGIN ProductReviewDetails.jsp --> 


<%@ taglib uri="http://java. sun.com/jsp/jstl/fmt" prefix="fmt" %> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/functions" prefix="fn" %> 
<%@ taglib uri="http://java. sun.com/jsp/jstl/core" prefix="c" %> 

<%@ taglib uri="http://commerce. ibm.com/base" prefix="wcbase" %> 

<%@ taglib uri="http://commerce. ibm.com/foundation" prefix="wcf" %> 

<%@ include file=" ../../../. ./incl ude/parameters . jspf " %> 

<%@ include file=" ../../. ./incl ude/JSTLEnvi ronmentSetup. jspf" %> 

<%-- 1. Retrieve data --%> 

<! DOCTYPE html PUBLIC "-//WAPFORUM//DTD XHTML Mobile 1.2//EN" 
"http://www.openmobi leal liance.org/tech/DTD/xhtml -mobi lel2.dtd"> 

<html xml ns=" http: //www. w3.org/ 1999/xhtml " 1 ang="${shortLocal e} " 
xml :lang="${shortLocale}"> 

<head> 
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<t i t 1 e> 

<fmt:message key="REVIEW_DETAILS_TITLE" bundle="${storeText} " />: 
<c:out val ue="${catal ogEntry. descript ion. name} " escapeXml ="fal se"/> 
</title> 

<meta http-equiv="content-type" content="application/xhtml+xml" /> 
<meta http-equi v="cache-control " content="max-age=300" /> 

<meta name="viewport" content="width=device-width, initial-scale=1.0, 
user-seal able=no" /> 

<1 i nk rel="stylesheet" href="${cssPath}"/> 

</head> 

<body> 

<div id="wrapper"> 

<%@ include fi 1 e=" ./incl ude/HeaderDi spl ay .jspf" %> 

<%@ incl ude fi 1 e=" ./incl ude/BreadCrumbTrai 1 Di spl ay . jspf"%> 

<%out.fl ush() ;%> 

<div id="review_details" cl ass="content_box"> 

<di v cl ass="headi ng_contai ner"> 

<h2xfmt:message key="REVIEW_DETAILS_TITLE" 
bundle="${storeText}" /></h2> 

<di v cl ass="cl ear_f 1 oat"></di v> 

</di v> 

<%-- 2. Main content --%> 

</di v> 

<%out.fl ush() ;%> 

<%@ include fi 1 e=" ./incl ude/FooterDi spl ay .jspf " %> 

</di v> 

</body> 

</html> 

<!-- END ProductReviewDetails.jsp --> 


The code in Example 5-104 establishes the headers and footers, includes the 
dependent JSP files, and displays the title text in the main content area. 

4. Next, you need to add the code to retrieve the necessary data for the JSP. 
Locate the following line comment in the code that you inserted in the 
previous step: 

<%-- 1. Retrieve data --%> 
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5. Insert the code from Example 5-105 after the line comment, and save the file 
by pressing Ctrl+S. 

Example 5- 1 05 Data retrieval code for ProductReviewDetails.jsp 

<c:set var="pgGrp" value="${WCParam.pgGrp}" /> 

<c:choose> 

<c:when test= 1 $ { pgGrp == "prodComp"} '> 

<c:set var="prodComparePageGroup" value="true" scope="request"/> 

</c:when> 

<c:when test= 1 $ { pgGrp == "search"} ’> 

<c:set var="searchPageGroup" value="true" scope="request"/> 

</c:when> 

<c:when test= ' $ { pgGrp == "wishl ist"} '> 

<c:set var="wishl i stPageGroup" value="true" scope="request"/> 

</c:when> 

<c:otherwise> 

<c:set var="categoryNavPageGroup" value="true" scope="request"/> 

</c:otherwise> 

</c:choose> 

<c:set var="productReviewPage" value="true" scope="request"/> 

<c:set var="productReviewDetai 1 sPage" val ue="true" scope="request"/> 

<c:set var="productId" value="${WCParam.productId}" /> 

<wcbase:useBean id="catalogEntry" 

cl assname="com. i bm. commerce . catal og . beans . Catal ogEntryDataBean" /> 

<c:set var="partNumber" value="${catalogEntry.partNumber}" /> 

<wcbase:useBean id="reviews" 

cl assname= "com. ibm. i tso. commerce. soccom. beans. ReviewsDataBean"> 

<c:set property="sortOptions" value="rating|desc" target="${reviews} "/> 

<c:set property="partNumber" val ue="${partNumber} " target="${reviews} "/> 
</wcbase:useBean> 

<wcf :url var="productDi spl ayLi nk" val ue="mProductDi spl ayVi ew"> 

<c:forEach var="parameter" items="${WCParamVal ues} "> 

<c:forEach var="value" items="${parameter.value}"> 

<c:if test="${parameter.key != 'reviewld' }"> 

<wcf:param name="${parameter. key} " value="${value}" /> 

</c : i f > 

</c:forEach> 

</c:forEach> 

</wcf :url> 

<wcf:url var="reviewListUrl " val ue="mProductReviewsView"> 

<c:forEach var="parameter" items="${WCParamVal ues} "> 
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<c:forEach var="value" items="${parameter.value}"> 

<c:if test="${parameter.key != 'reviewld' }"> 

<wcf:param name="${parameter. key} " value="${value}" /> 
</c : i f > 

</c:forEach> 

</c:forEach> 

</wcf :url> 

<%-- determine next and previous review for paging --%> 

<c:set var="seenThisOne" val ue="fal se" /> 

<c : forEach var="revi ew" i tems="$ {revi ews . revi ewDetai 1 sMap} "> 

<c:if test="${seenThisOne && empty nextReview} "> 

<c:set var="nextReview" val ue="${review.val ue} " /> 

</c:if> 

<c:if test="${review. val ue. reviewld eq WCParam.reviewId}"> 
<c:set var="previousReview" val ue="${prev} " /> 

<c:set var="seenThisOne" value="true" /> 

</c:if> 

<c:set var="prev" val ue="${review.val ue} " /> 

</c:forEach> 

<wcf:url var="prevReviewDetai 1 sllrl " value="mReviewDetails"> 
<c:forEach var="parameter" items="${WCParamVal ues} "> 

<c:forEach var="value" items="${parameter.value}"> 

<c:if test="${parameter.key != 'reviewld' }"> 

<wcf:param name="${parameter. key} " value="${value}" /> 
</c : i f > 

</c:forEach> 

</c:forEach> 

<wcf :param name="reviewld" val ue="${previousReview. reviewld} "/> 
</wcf :url> 

<wcf:url var="nextReviewDetai 1 sllrl " value="mReviewDetails"> 
<c:forEach var="parameter" items="${WCParamVal ues} "> 

<c:forEach var="value" items="${parameter.value}"> 

<c:if test="${parameter.key != 'reviewld' }"> 

<wcf:param name="${parameter. key} " value="${value}" /> 
</c : i f > 

</c:forEach> 

</c:forEach> 

<wcf:param name="reviewld" value="${nextReview.reviewId}"/> 
</wcf :url> 


The code in Example 5-105 sets up breadcrumb display variables, retrieves 
the product ID from the request parameters, instantiates and populates a 
CatalogEntryDataBean instance to get the part number, and then instantiates 
and populates a ReviewsDataBean instance to retrieve the review details for 
the product. Then, the URLs for product display and the review list are 
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generated for later use. Finally, the code determines the correct URLs to use 
for paging support. 

6. Next, you need to add the overall rating for the product and the button for 
writing a review and finally the review details themselves. In the source code 
editor for ProductReviewDetails.jsp, locate the following line comment: 

<%-- 2. Main content --%> 

7. Insert the code from Example 5-106 after this line comment, and press Ctrl+S 
to save the file. 

Example 5-106 Overall rating code for ProductReviewDetails.jsp 
<P> 

<a href="${productDi spl ayLi nk} "> 

<c:out value="${catalogEntry. description. name}" /> 

</a> 

</p> 

<p><fmt: message key="RATING_OVERALL_TITLE" bundl e="${storeText} " /> 

<%out.fl ush() ;%> 

<c: import url="${jspStoreDir}mobile/Snippets/ReusableObjects/StarRating.jsp"> 

<c:param name="lowerBound" value="${reviews.lowerBound}" /> 

<c:param name="upperBound" value="${reviews.upperBound}" /> 

<c:param name="rating" val ue="${reviews.avgOveral 1 Rating} " /> 

</c:import> 

<%out.fl ush() ;%> 

</p> 

<%@include file=". ./. ./. ./Snippets/Catalog/Reviews/WriteReviewLink.jspf" %> 

<c:set var="reviewDetai 1 s" value="${reviews.reviewDetailsMap[WCParam.reviewId] }" /> 
<div class="review_info"> 

<%@include file=". ./. ./. ./Snippets/Catalog/Reviews/ReviewHeadingDisplay.jspf" %> 
</di v> 

<p><c:out value="${reviewDetails.reviewText}" /></p> 

<c:if test="${ ! (empty nextReview && empty previousReview) } "> 

<div class="paging_control "> 

<c:if test="${ lempty previousReview} "> 

<span class="bullet">&#171; </span> 

<a href="${fn:escapeXml (prevReviewDetailslIrl)}" 

ti tl e="<fmt :message key= 1 REVIEW_DETAILS_PREVIOUS ' 
bundle='${storeText} ' />"> 

<fmt:message key="REVIEW_DETAILS_PREVIOUS" bundl e="${storeText} " /> 
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</a> 

</c:if> 

<c:if test="${ Iempty nextReview} "> 

<c:if test="${ iempty previousReview} "> 

&nbsp; 

</c:if> 

<a href="${fn:escapeXml (nextReviewDetailslIrl)}" 

title="<fmt:message key= 1 REVIEW_DETAILS_NEXT 1 
bundle='${storeText} 1 />"> 

<fmt: mess age key="REVIEW_DETAILS_NEXT" bundl e="${storeText} " /> 
</a><span class="bul let"> &#187;</span> 

</c : i f > 

</div> 

</c : i f > 

<div class="paging_control "> 

<span class="bullet">&#171; </span> 

<a href="${fn:escapeXml (reviewLi stllrl ) } " 

title="<fmt:message key= 1 REVIEW_DETAILS_BACK' bundl e= 1 ${storeText} 1 />"> 
<fmt:message key="REVIEW_DETAILS_BACK" bundl e="${storeText} " /> 

</a> 

</div> 


The code in Example 5-106 displays the overall rating along with a link to the 
Write a Review page, followed by the review details, including the user name 
of the reviewer, the date the review was submitted, and the actual review text. 

5.5.12 Create the JSP for writing the review 

You create the PostReview. jsp file to enable user to write a new review for the 
product. The user must be logged in to write a review. If the user is not logged in, 
you can display a message and suggest that the user log in to write the review, 
as shown in Figure 5-52. 


MADISONS MOBILE 

Sian In 

Home | Blue Fabric Love Seat 



Write a Review 

Blue Fabric Love Seat 

■"Indicates required fields 

Review could not be created. Register to 

create a new review or Sian In in if you are 

already a member. 

Figure 5-52 Write a review page for a guest user 
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To create the write a review PostReview. jsp: 

1 . Create a new JSP file named PostReview. jsp in the following directory: 
Stores/WebContent/Madi sons/mobi 1 e/Shoppi ngArea/Catal ogSecti on/Revi ew 
Subsection 

2. Begin by creating the skeleton HTML document. Open the JSP editor, and 
enter the code shown in Example 5-107. Press Ctrl+S to save the file. 


Example 5- 1 07 Skeleton code for the PostReview.jsp file 



* This JSP takes the review inputs and submits to PostReviewCmd. 


<!-- BEGIN PostReview.jsp --> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/fmt" prefix="fmt" %> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/functions" prefix="fn" %> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/core" prefix="c" %> 

<%@ taglib uri="http://commerce. ibm.com/base" prefix="wcbase" %> 

<%@ taglib uri="http://commerce. ibm.com/foundation" prefix="wcf" %> 

<%@ include file=" ../../../. ./incl ude/parameters . jspf " %> 

<%@ include file=" ../../. ./incl ude/JSTLEnvi ronmentSetup. jspf" %> 

<%@ include file=" ../../. ./incl ude/ErrorMessageSetup. jspf" %> 

<%— 1. Initialize beans and URL links --%> 

<! DOCTYPE html PUBLIC "-//WAPFORUM//DTD XHTML Mobile 1.2//EN" 
"http://www.openmobi leal liance.org/tech/DTD/xhtml -mobi lel2.dtd"> 

<html xml ns=" http: //www. w3.org/ 1999/xhtml " 1 ang="${shortLocal e} " 
xml :lang="${shortLocale}"> 

<head> 

<title> 

<fmt:message key="WRITE_REVIEW_TITLE" bundl e="${storeText} " />: 
<c:out val ue="${catal ogEntry. descript ion. name} " escapeXml ="fal se"/> 
</title> 

<meta http-equi v="content-type" content="application/xhtml+xml" /> 
<meta http-equi v="cache-control " content="max-age=300" /> 

<meta name="viewport" content="width=device-width, initial-scale=1.0, 
user-seal able=no" /> 

<1 i nk rel="stylesheet" href="${cssPath}"/> 
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:/head> 


<body> 

<div id="wrapper"> 

<%@ include fi 1 e=" ./incl ude/HeaderDi spl ay .jspf" %> 

<%@ incl ude fi 1 e=" ./incl ude/BreadCrumbTrai 1 Di spl ay . jspf"%> 

<%out.fl ush() ;%> 

<div id="write_review" cl ass="content_box"> 

<di v cl ass="headi ng_contai ner"> 

<h2><fmt message key="REVIEW_WRITE_REVIEW" 
bundle="${storeText}" /></h2> 

<di v cl ass="cl ear_f 1 oat"></di v> 

</di v> 

<%-- 2. Main content --%> 

</di v> 

<%out.fl ush() ;%> 

<%@ include fi 1 e=" ./incl ude/FooterDi spl ay .jspf " %> 

</di v> 

</body> 

</html> 

<!-- END PostReview. jsp --> 


3. Now, add the code to retrieve product details and to generate the product 
display page link, as shown in Example 5-108. Add this code after the 
following line from Example 5-107 on page 370: 

<%-- 1. Initialize beans and URL links --%> 

Example 5- 1 08 Initialization code for the PostReview.jsp file 

<c:set var="pgGrp" value="${WCParam.pgGrp}" /> 

<c:choose> 

<c:when test= 1 $ { pgGrp == "prodComp"} '> 

<c:set var="prodComparePageGroup" value="true" scope="request"/> 

</c:when> 

<c:when test= 1 $ { pgGrp == "search"} ’> 

<c:set var="searchPageGroup" value="true" scope="request"/> 

</c:when> 

<c:when test= 1 $ {pgGrp == "wishl ist"} '> 
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<c:set var="wishl i stPageGroup" value="true" scope="request"/> 
</c:when> 

<c:otherwise> 

<c:set var="categoryNavPageGroup" value="true" scope="request"/> 
</c:otherwise> 

</c:choose> 

<c:set var="productReviewPage" val ue="true" scope="request"/> 

<c:set var="productReviewPostPage" value="true" scope="request"/> 

<c:set var="starImgPath" value="/soccom/ibm/social/images/" /> 

<wcbase:useBean id="catalogEntry" 

cl assname="com. i bm. commerce . catal og . beans . Catal ogEntryDataBean" /> 
<wcf :url var="productDi spl ayLi nk" val ue="mProductDi spl ayVi ew"> 
<c:forEach var="parameter" items="${WCParamVal ues} "> 

<c:forEach var="value" items="${parameter.value}"> 

<c:if test="${parameter.key != 'reviewld' }"> 

<wcf:param name="${parameter. key} " value="${value}" /> 

</c : i f > 

</c:forEach> 

</c:forEach> 

</wcf :url> 

<wcf:url var="reviewListUrl " val ue="mProductReviewsView"> 

<c:forEach var="parameter" items="${WCParamVal ues} "> 

<c:forEach var="value" items="${parameter.value}"> 

<c:if test="${parameter.key != 'reviewld' }"> 

<wcf:param name="${parameter. key} " value="${value}" /> 

</c : i f > 

</c:forEach> 

</c:forEach> 

</wcf :url> 


4. Add the code for error handling as follows: 

a. Check for any exceptions thrown from the command. 

b. If the exceptions are found, check if the exception is because the user is 
not logged in. 

c. If the user is not logged in, display the message for the user to register or 
to log in. 

d. If the exception is for anything other than this, display the exception 
message and the write review form. 
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Example 5-109 shows the code snippet for exception handling. 

Example 5- 1 09 Exception Handling for PostReview.jsp 

<a href="${productDi splay Link} "><c:out 
value="${catalogEntry. description. name}" /></a> 

<P> 

<span class="field_required_symbol ">*</span> 

<fmt:message key="REQUIRED_FIELDS" bundl e="${storeText} " /> 

</p> 

<c:choose> 

<c:when test="${ iempty storeError. key && 

storeError.key == '_ERR_USER_NOT_LOGGED_IN 1 }"> 

<wcf:url var="logonURL" val ue="Mobi 1 eLogonForm"> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 
<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 
<wcf:param name="l angld" val ue="${WCParam. 1 angld} " /> 

</wcf :url> 

<wcf:url var="registerURL" 

val ue="Mobi 1 ellserRegi strati onAddForm"> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} " /> 
<wcf:param name="storeId" val ue="${WCParam.storeId} " /> 
<wcf:param name="l angld" val ue="${WCParam. 1 angld} " /> 
<wcf:param name="regi ster_button" val ue="Register" /> 

</wcf :url> 

<fmt:message key="WRITE_REVIEW_ERROR" bundl e="${storeText} " /> 
<fmt:message key="WRITE_REVIEW_REGISTER_OR_LOGIN" 
bundl e="$ { storeText } "> 

<fmt:param val ue="${fn:escapeXml (regi sterURL) } " /> 
<fmt:param val ue="${fn:escapeXml (logonURL) } " /> 
</fmt:message> 

</c:when> 

<c:otherwise> 

<c:choose> 

<c:when test="${ iempty errorMessage} "> 

<p class="error"><c:out val ue="${errorMessage} " /></p> 
</c:when> 

<c:otherwise> 

<c:if test="${ iempty storeError. key} "> 

<p class="error"><c:out val ue="${storeError. key} " /></p> 
</c : i f > 

</c:otherwise> 

</c:choose> 
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5. Write the code for creating and submitting the Write Review form, as shown in 
Example 5-1 1 0. Insert this code after the code from Example 5-109 on 
page 373. The form submits to action PostReview, which is described in 
5.5.13, “Create the command to post the review” on page 375. 

Example 5-110 Submission form for the PostReview.jsp file 

<form method="post" action="PostReview"> 

<fieldset> 

<P> 

<span class="field_required_symbol ">*</span> 

<fmt:message key= " S ELECT_REV I EW_RAT I NG " bundle="${storeText} " /> 

</p> 

<ul class="rating"> 

<c:forEach var="item" begin="l" end="5"> 

<1 i> 

<input type="radio" name="rating" val ue="${item} " 
i d= " rati ng_${ item}" /> 

<fmt:message var="ratingTitle" key="REVIEW_RATING_${item} " 
bundle="${storeText}" /> 

<1 abel for="rating_${item}" title="${ratingTitle}"> 

<%0Ut.fl ush() ;%> 

<c: import 

url="${jspStoreDir}mobile/Snippets/ReusableObjects/StarRating.jsp"> 
<c:param name="l owerBound" value="0" /> 

<c:param name="upperBound" value="5" /> 

<c:param name="rati ng" val ue="${item} " /> 

</c:import> 

<%out.fl ush() ;%> 

</l abel > 

</li> 

</c:forEach> 

</ u 1 > 

<div class="input_container"> 

<di v> 

<1 abel for="revi ew_ti tl e"><span cl ass="f i el d_requi red_symbol ">*</span> 
<fmt:message key="ENTER_REVIEW_TITLE" bundl e="${storeText} " /></l abel > 

</di v> 

<input type="text" id="review_title" name="title" class="coloured_input" /> 

</di v> 

<di v cl ass="textarea_contai ner"> 

<di v> 

<1 abel for="review_comments"><span cl ass="f i el d_requi red_symbol ">*</span> 
<fmt:message key= " ENTER_REV I EW_COMMENTS " bundl e="${storeText} " /></l abel > 
</di v> 
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<textarea id="review_comments" name="body" class="coloured_input" 
rows="8"></textarea> 

</di v> 

<input type="hidden" name="partNumber" val ue="${WCParam.partNumber} "/> 
<c:forEach var="parameter" items="${WCParamVal ues} "> 

<c:forEach var="value" items="${parameter.value}"> 

<input type="hidden" name="${parameter.key} " val ue="${val ue} "/> 
</c:forEach> 

</c:forEach> 

<input type="hidden" name="URL" val ue="mPostReviewsView"/> 

<input type="hidden" name="viewTaskName" val ue="mPostReviewsView"/> 

<input type="hidden" name="errorViewName" value="mPostReviewsView"/> 
<input type="hidden" name="onPage" value="l"/> 

<input type="hidden" name="sortOptions" value="submissionTime|desc" /> 
<input type="submit" id="create_review" name="create_review" 

val ue="<fmt:message key="REVIEW_SUBMIT" bundle="${storeText} " />" 
class="submit" /> 

<input type="button" id="cancel_review" name="cancel_review" 

val ue="<fmt:message key="REVIEW_CANCEL" bundle="${storeText} " />" /> 
</fieldset> 

</form> 

<p><fmt:message key="WRITE_REVIEW_DELAY" bundl e="${storeText} " /x/p> 
</c:otherwise> 

</c:choose> 


This completes the implementation of the PostReview.jsp file. You cannot view 
this page until you complete the steps described in 5.5.14, “Modify infrastructure 
resources” on page 384. 

5.5.13 Create the command to post the review 

You need to submit the PostReview.jsp file that you created in the previous 
section to a controller command. In this section, we explain how to create the 
PostReviewCmdlmpl command to post the reviews to the Social Commerce 
application. To post a review to the Social Commerce application, the user must 
have logged in to the mobile storefront and have the LtpaToken2 cookie in the 
browser. The LtpaToken2 cookie is set when a user logs in to the storefront. 
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Note: The LtpaToken2 cookie is set only when the Social Commerce feature is 
configured as documented in the WebSphere Commerce Version 7 
Information Center: 

http : //publ i b . boul der . i bm.com/infocenter/wchel p/v7rOmO/topi c/com. i bm 
.commerce. instal 1 .doc/tasks/t igsoccom.htm 

When running the Social Commerce setup wizard, you can choose whether to 
use LDAP and LTPA or IBM WebSphere Commerce V7 to generate 
authentication cookies. 


The command for posting reviews needs to submit a JSON object to the Social 
Commerce application. In the spirit of RESTful APIs, the URI for submitting a 
review is the same as that for retrieving the list of existing reviews: 

/i terns/ i temld/revi ews 

The difference, however, is that the HTTP request method for posting reviews is 
POST. Along with the request, you need to post a data structure of the syntax 
shown in Example 5-111. 

Example 5-111 Post review data structure 

{ 

“title" :{ "type": "string" }, 

"body":{ "type": "string" }, 

"rating" :{ "type": "float" }, 

"ItemDescription": { "type": "string" }, 

} 


Example 5-112 shows a sample request for write review query to the Social 
Commerce application. 

Example 5- 1 12 Post review request JSON object 

{"title": "test review", "body": "this is a test 
rev i ew" , " rat i ng " : " 5 " , " i temDes cr i pt i on " : " FU LO-0 1 " } 


Example 5-113 shows a sample response for write review query to the Social 
Commerce application. 

Example 5-113 Post review response JSON object 

{"status" : 204, "message" : " ", "data" :{ "i sRati ngOnly" :fal se, "reviewld" : "123 
","reviewText":"this is a test review" , "userid" :nul 1 , "titl e" : "test 
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review", "I temDescript ion" : " FUL0-01" , "submissionTime" : "2009-08-26T19:01 : 
5 1 . 781 " , " rat i ng " : 5 , " i teml d " : " FU LO-0 1 " } } 


To implement the PostReviewCmd interface 

1. Create a new package named com. xxx. commerce. soccom. commands, where 
xxx is the name of your company in the 

WebSphereCommerceServerExtensionsLogic project. We chose the package 
name com. ibm.itso. commerce. soccom. commands. 

2. Create the PostRevi ewCmd interface in the package. This interface extends the 
com. ibm. commerce. command. Control lerCommand interface. Example 5-114 
provides the full code for the interface. 

Example 5-114 Source code for PostReviewCmd 
package com. i bm . i tso . commerce . soccom . commands ; 

import com .ibm. commerce . command . Control 1 erCommand ; 

public interface PostReviewCmd extends Control 1 erCommand { 

public static final String NAME = PostRevi ewCmd. cl ass. getName () ; 
public static final String defaultCommandClassName = 

PostRevi ewCmdlmpl . class. getNameQ ; 

} 


3. Create the PostRevi ewCmdlmpl implementation class for this interface. The 
implementation class extends the 

com. ibm. commerce. command. Control lerCommand Impl and implements the 
PostReviewCmd interface that you created in the previous step. 

4. Declare the constants and attributes as shown in Example 5-115. 

Example 5-115 Constants and attributes for PostReviewCmdlmpI 

private static final String CLASS_NAME = 

PostReviewCmd Impl .class. getName ( ) ; 
private static final Logger LOGGER = Logger. getLogger(CLASS_NAME) ; 

private String strPartNumber; 
private String strTitle; 
private String strBody; 
private String strRating; 
private Cookie authCookie = null; 

public static final ECMessage _ERR_USER_NOT_LOGGED_IN = 
new ECMessage ( 

ECMessageSeverity. ERROR, ECMessageType.USER, 
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"_ERR_USER_NOT_LOGGED_IN" , "ecUserDefi nedMessages") ; 

public static final ECMessage _ERR_CANNOT_WRITE_REVIEW = 
new ECMessage ( 

ECMessageSeverity. ERROR, ECMessageType.USER, 
"_ERR_CANNOT_WRITE_REVIEW" , "ecUserDefi nedMessages") ; 


Note: The ECMessage instances _ERR_USER_NOT_LOGGED_IN and 
_ERR_CANNOT_WRITE_REVIEW messages in Example 5-115 are normally 
declared in a custom ECMessage class that is created for your application. 
We declared it in PostReviewCmdlmpl for brevity. 


5. Implement the setRequestProperti es method as shown in Example 5-1 1 6. 
The code retrieves the values of part number, rating, review title, and body 
parameters as well as the Ltpa2Token cookie from the request. 

Example 5-116 The setRequestProperties method for PostReviewCmdlmpl 

public void setRequestProperti es (TypedProperty reqParms) 
throws ECAppl icationException { 
final String METHOD_NAME = "setRequestProperties"; 

LOGGER. entering (CLASSJAME, METHOD_NAME) ; 

requestProperties = reqParms; 

strPartNumber = reqParms. getString("partNumber", null); 
strTitle = reqParms. getString("title", null); 
strBody = reqParms. getString("body", null); 
strRating = reqParms. getString("rating", null); 

// we assume that this command is invoked from the HTTP channel 
ViewCommandContext viewCmdCtx = 

(ViewCommandContext)getCommandContext() ; 

Cookie[] cookies = ((HttpControl lerRequestObject) 

(vi ewCmdCtx. getRequest () ) ) . getHttpRequest () . getCooki es () ; 
for (int i = 0; i < cookies. length; i++) { 

if (cookies[i] .getName() .equals("LtpaToken2")) { 
authCookie = cookies[i]; 

LOGGER. logp(Level .FINE, CLASSJAME, METHOD JAME, 

"Found authentication cookie"); 


if (authCookie == null) { 

// User is not logged in 

LOGGER. logp(Level .SEVERE, CLASSJAME, METHOD JAME, 
"_ERRJSERJ0T_L0GGED_IN key" 
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+_ERR_USER_NOT_LOGGED_IN.getMessageKey ()) ; 

throw new ECAppl icationException( 
_ERR_USER_NOT_LOGGED_IN, 

CLASSJAME, 

METHOD_NAME, "mPostReviewsView") ; 

} 

LOGGER. exi ting (CLASSJAME, METHOD_NAME) ; 


6. Implement the val i dateParameters method as shown in Example 5-1 1 7. This 
method validates all the input parameters (part number, rating, title, and body 
all are required parameters). If any of these parameters is null, an 
ECAppl icationExcepti on is thrown. 

Example 5-117 The validateParameters method for PostReviewCmdlmpI 

public void val i dateParameters () throws ECException { 

final String METHOD_NAME = "validateParameters"; 

LOGGER, entering (CLASSJAME, METHOD_NAME) ; 

if (strPartNumber == null || strPartNumber.equals("")) { 
TypedProperty hshNVPs = new TypedProperty () ; 
hshNVPs . put ( " ErrorCode" , "20010"); 
throw new ECAppl icationExcepti on ( 

ECMessage._ERR_CMD_MISSING_PARAM, 

CLASSJAME, METHOD JAME, 

ECMessageHel per.generateMsgParms ("partNumber") , 
"mPostReviewsView", hshNVPs); 

} 

if (strRating == null || strRating.equals("")) { 

TypedProperty hshNVPs = new TypedProperty () ; 
hshNVPs. put ("ErrorCode", "20011"); 
throw new ECAppl icationExcepti on ( 

ECMessage._ERR_CMD_MISSING_PARAM, 

CLASSJAME, METH0DJAME, 

ECMessageHel per.generateMsgParms ("rating") , 
"mPostReviewsView", hshNVPs); 

} 

if (strTitle == null || strTitle.equals("")) { 

TypedProperty hshNVPs = new TypedProperty () ; 
hshNVPs. put("ErrorCode", "20012"); 
throw new ECAppl icationExcepti on ( 

ECMessage._ERR_CMDJISSING_PARAM, 
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CLASS_NAME, METHOD_NAME, 

ECMessageHel per. generateMsgParms ( "title") , 
"mPostReviewsView", hshNVPs) ; 

} 

if (strBody == null || strBody.equals("")) { 
TypedProperty hshNVPs = new TypedProperty () ; 
hshNVPs.put("ErrorCode", "20013") ; 
throw new ECAppl icationException( 

ECMess age . _ERR_CMD_M I SS I NG_PARAM , 
CLASS_NAME, METH0D_NAME, 

ECMessageHel per. generateMsgParms ("body") , 
"mPostReviewsView", hshNVPs); 

} 


LOGGER.exiting(CLASS_NAME, METH0D_NAME) ; 

} 


7. Implement the performExecute method as shown in Example 5-118. The 
main logic is delegated to the executeRequest and handleResponse methods 
that will be implemented in later steps. 

Example 5-118 The performExecute code sample 

public void performExecute () throws ECException { 
final String METH0D_NAME = "performExecute"; 

LOGGER. entering (CLASS_NAME, METH0D_NAME) ; 
try { 

super. performExecute () ; 

HttpResponse response = executeRequest () ; 
handleResponse(response) ; 

} catch (IOException e) { 

LOGGER. logp(Level .SEVERE, CLASS_NAME, METH0D_NAME, 
"IOException: "+e.getMessage()) ; 

throw new ECAppl i cati onExcepti on (_ERR_CANNOT_WRITE_REVI EW, 
CLASS_NAME, METH0D_NAME, "mPostReviewsView"); 

} 

if (responseProperties == null) 

responseProperties = new TypedPropertyO ; 
responseProperties . remove (ECExcepti on . ECMESSAGE) ; 
requestPropert i es . remove ( ECExcepti on . ECMESSAGE) ; 
responseProperties. put ( ECConstants. EC_VIEWTASKNAME, 

ECConstants .EC_GENERIC_REDIRECTVIEW) ; 

responseProperties . put ( ECConstants . EC_URL, 

"mProductReviewsView") ; 
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LOGGER. exiting(CLASS_NAME, METHOD_NAME) ; 


8. Implement the executeRequest method as shown in Example 5-1 1 9. 

Example 5-119 Source code for the executeRequest method 

private HttpResponse executeRequest () 

throws UnsupportedEncodingException, IOException, 

Cl i entProtocol Exception { 
final String METHOD_NAME = "executeRequest"; 

LOGGER. entering (CLASS_NAME, METHOD_NAME) ; 

String urlString = "http://local host/soccom/api/items/" 

+ strPartNumber + "/reviews"; 

HttpClient client = new Defaul tHttpCl ient() ; 
cl ient.getParamsQ .setParameter("http. socket. timeout" , 
new Integer(5000)) ; 

cl i ent . getParams () . setParameter ( "http . protocol . content-charset" , 
"utf-8") ; 


if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. logp(Level .FINE, CLASS_NAME, METHOD_NAME, 
"URL: {0}", urlString); 

} 


HttpPost method = new HttpPost (urlString) ; 

String entitystring = " {V'titl e\" 

+ strTitle + "\",\"body\":\"" + strBody 
+ "\",\"rating\":\"" + strRating 
+ "\",\"itemDescription\":\"" + strPartNumber + 

if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. logp(Level .FINE, CLASS_NAME, METH0D_NAME, 
"Entity: {0}", entitystring); 

} 


HttpEntity requestEntity = 

new ByteArray Ent i ty (ent i tyStri ng . getBytes ( " UTF-8" ) ) ; 
method . set Ent i ty (requestEnti ty) ; 

method. get Params() .set Parameter ("http. socket. timeout", 
new Integer (5000)); 

method. setHeader("Cookie" , "LtpaToken2="+authCookie.getVal ue()) ; 
method.setHeader( "Content-Type" , 
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"text/json-comment-filtered; charset=utf-8") ; 
HttpResponse response = cl ient.execute(method) ; 
LOGGER. exiting(CLASS_NAME, METHOD_NAME, response); 
return response; 


9. Add the code for handleResponse as shown in Example 5-120. 

Example 5- 120 Source code for handleResponse 

private void handleResponse(HttpResponse response) 
throws IOException, ECAppl icationException { 
final String METHOD_NAME = "handleResponse"; 

LOGGER. entering (CLASS_NAME, METHOD_NAME) ; 

int statuscode = response. getStatusLine() .getStatusCode() ; 

if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. logp(Level .FINE, CLASS_NAME, METHOD_NAME, 

"HTTP status code: {0}", statuscode); 

} 

HttpEntity entity = response. getEntity() ; 

String responsestring = 

String message = 
if (entity != null) { 

long len = entity. getContentLength() ; 
if (len != -1) { 

responsestring = Entitylltils.toString(entity); 
try { 

JSONObject json = new JSONObject(responseString) ; 
message = json.getString("message") ; 

} catch (JSONException e) { 

LOGGER. logp(Level .SEVERE, CLASS_NAME, METHOD_NAME, 
"Error generating JSON object", e); 
throw new ECAppl icationExcepti on ( 
_ERR_CANNOT_WRITE_REVIEW, 

CLASS_NAME, METHOD_NAME, "mPostRevi ewsVi ew") ; 

} 


if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. logp(Level .FINE, CLASS_NAME, METHOD_NAME, 
"HTTP response: \"{0}\"", responsestring); 

} 

if (statuscode == 404) { 
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if ("ERR_NOT_LOGGED_IN". equals (message)) { 

// User is not logged in 

LOGGER. logp(Level. SEVERE, CLASS_NAME, METHODJAME, 
"_ERR_USER_NOT_LOGGED_IN key" 
+_ERR_USER_NOT_LOGGED_IN.getMessageKey ()) ; 

throw new ECAppl icationException( 
_ERR_USER_NOT_LOGGED_IN, 

CLASSJAME, 

METHOD_NAME, "mPostReviewsView") ; 


else { 

LOGGER. logp(Level .SEVERE, CLASSJAME, 

METHODJAME, responsestring); 

// could not write a review 
throw new ECAppl icationExcepti on ( 
_ERR_CANNOTJRITEJEVIEW, 

CLASSJAME, METHODJAME, "mPostReviewsView"); 


LOGGER. exi ting (CLASSJAME, METHODJAME); 

} 


10. The PostReviewCmdlmpl class is almost finished. All you need to do is add the 
import statements. Add the imports from Example 5-121 to the beginning of 
the PostReviewCmdlmpl source file. 

Example 5- 121 Import statements for PostReviewCmdlmpl 


import java.io.IOException; 

import java.io. Unsupported Encoding Except ion; 

import java. util .logging. Level ; 

import java. util .logging. Logger; 

import javax. servlet. http. Cookie; 

import org .apache. http. HttpEnti ty ; 

import org. apache. http. HttpResponse; 

import org. apache. http. cl ient. Cl ientProtocol Exception; 

import org. apache. http. cl ient. HttpCl ient; 

import org. apache. http. cl ient. methods. HttpPost; 

import org .apache. http. enti ty . ByteArrayEnti ty ; 

import org. apache. http. impl .cl ient. Defaul tHttpCl ient; 

import org. apache. http. util . Enti tyUt i Is; 

import org.json. JSONException; 
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import org.json. JSONObject; 


import com . i bm . commerce . command . Control 1 erCommand Impl ; 

i mport com . i bm . commerce . command . V i ewCommandContext ; 

import com. ibm. commerce. datatype. Typed Property; 

import com. ibm. commerce. except i on. ECAppl i cat ionExcept ion; 

import com. i bm. commerce. except i on. ECExcepti on; 

import com .ibm. commerce . ras . ECMessage ; 

import com. i bm. commerce . ras . ECMessageHel per; 

import com. i bm. commerce . ras . ECMessageSeveri ty ; 

import com .ibm. commerce . ras . ECMessageType ; 

import com. ibm. commerce. server. ECConstants; 

import com. ibm. commerce. webcontrol ler.HttpControl lerRequestObject; 


11. Open the 

Stores/JavaSource/Madi sons/mobi 1 e/storeErrorMessages . properties file, 
and add error keys from Example 5-122 to the end of the file. 

Example 5- 122 Custom error messages 


_ERR_USER_NOT_LOGGED_IN = Please Sign-in to write a review. 
_ERR_CANNOT_WRITE_REVIEW = Error while creating review. \ 
Review not created. 

_ERR_CMD_I NVALI D_PARAM .20010 = Part Number is missing. 
_ERR_CMD_I NVALI D_PARAM .20011 = Select a rating for the review. 
_ERR_CMD_I NVALI D_PARAM .20012 = Enter title for the review. 
_ERR_CMD_I NVALI D_PARAM .20013 = Enter review comments. 


12. To complete this process, complete the steps in the next section. 


5.5.14 Modify infrastructure resources 

In this section, you modify the shared resources that need to be changed to 
support the modified and new pages and commands that you created. You need 
to complete the following steps: 

1 . Modify the bread crumb JSP fragment 

2. Modify the cascading style sheets 

3. Amend the struts configuration file 

4. Configure access control 

5. Define localized strings for pages 
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Modify the bread crumb JSP fragment 

To display the breadcrumb path properly on the new pages, you must update the 
JSP fragment that generates the breadcrumb: 

1 . Open the development environment by selecting Start 0 Programs 0 IBM 0 
WebSphere 0 WebSphere Commerce 0 WebSphere Commerce 
Developer Enterprise. 

2. Switch to the Java EE perspective if it is not already active: 

a. Select Window 0 Open Perspective 0 Other. 

b. The Open Perspective window opens. Select Java EE, and click OK. 

3. In the Enterprise Explorer, expand and double-click Stores 0 WebContent 0 
Madisons 0 mobile 0 include 0 BreadCrumbTrailDisplay.jspf. 

4. The file opens in the JSP source code editor. Locate the code shown in 
Example 5-57. 

Example 5-123 Code example 

<c:when test="${productPage || storeAvai 1 Page || storeDetai 1 Page} "> <%-- Product 
display page which is reached by clicking a product on the compare page --%> 


5. Update the code from Example 5-57 to look like the code in Example 5-58. 
The inserted code is highlighted in bold. 

Example 5-124 Code example 

<c:when test="${productPage || storeAvai 1 Page || storeDetai 1 Page || 
productReviewPage} "> <%-- Product display page which is reached by clicking a product 
on the compare page --%> 


6. Locate the code shown in Example 5-125. 

Example 5-125 Code example 

<c:when test="${storeAvai 1 Page || storeDetai 1 Page} "> 

<c: remove var="bctCatal ogEntry" scope="page"/> 

7. Update the code from Example 5-125 to look like the code in Example 5-126. 
The inserted code is highlighted in bold. 

Example 5-126 Code example 

<c:when test="${storeAvai 1 Page || storeDetai 1 Page || productReviewPage} "> 

<c: remove var="bctCatal ogEntry" scope="page"/> 
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8. Locate the code shown in Example 5-127. 


Example 5-127 Code example 

<a href="${fn:escapeXml (productDisplayUrl)}"><c:out val ue="${bctCatal ogEntry .descri pt 
ion. name}" /></a> 

<c:choose> 

<c:when test="${storeDetai 1 Page} "> 

<wcf :url var="i nStoreAvai 1 Detai 1 s" val ue="mInStoreAvai 1 abi 1 i tyDetai 1 sVi ew"> 

<wcf :param name="physicalStoreId" value="${WCParam.physicalStoreId}"/> 

<wcf :param name="physicalStoreIndex" val ue="${WCParam.physicalStoreIndex}"/> 
<wcf:param name="l angld" val ue="${WCParam. 1 angld} "/> 

<wcf:param name="productId" val ue="${WCParam.productId} "/> 

<wcf:param name="itemld" value="${WCParam.itemId}"/> 

<wcf:param name="catalogId" val ue="${WCParam.catalogId} "/> 

<wcf :param name="viewTaskName" val ue="${WCParam. viewTaskName} "/> 

<wcf :param name=" category Id" val ue="${WCParam. category Id } "/> 

<wcf:param name="storeId" val ue="${WCParam.storeId} "/> 

<wcf :param name="sel ectedVal ues" value="${WCParam.selectedValues}"/> 

<wcf:param name="pgGrp" val ue="prodComp"/> 

</wcf :url> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (inStoreAvailDetails)}"><c:out 
value="${physicalStores[i] .description[0] .name}" /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"> 

<fmt:message key="MST_VIEW_MAP" bundl e="${storeText} "/> 

</span> 

</c:when> 


9. Add the code from Example 5-128 after the code from Example 5-127. 

Example 5-128 Code example 

<c:when test="${productReviewPage} "> 

<c : i f test="${productRevi ewLi stPage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"><fmt:message key="REVIEW_LIST_TITLE" 
bundl e="${storeText} " /></span> 

</c : i f > 

<c : i f test="$ { productRevi ewDetai 1 s Page} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (reviewLi stUrl ) } "><fmt:message key="REVIEW_LIST_TITLE" 
bundl e="${storeText}" /></&> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"><fmt:message key="REVIEW_DETAILS_TITLE" 
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bundle="${storeText} " /></span> 

</c:if> 

<c : i f test="$ { productRevi ewPostPage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<a href="${fn:escapeXml (reviewLi stUrl ) } "><fmt:message key="REVIEW_LIST_TITLE" 
bundl e="${storeText}" /></a> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"><fmt:message key="WRITE_REVIEW_TITLE" 
bundl e="${storeText} " /></span> 

</c : i f > 

</c:when> 


10. Locate the code shown in Example 5-129. 

Example 5-129 Code example 

<c:when test="${productPage || wishl i stDi spl ayPage || prodComparePage || 

storeAvai 1 Page || storeDetail Page || shoppi ngcartDi spl ayPage} "> <%-- Product display 

page which is reached by clicking a product on the search page --%> 


1 1 . Update the code from Example 5-129 to look like the code in Example 5-1 30. 
The inserted code is highlighted in bold. 

Example 5-130 Code example 

<c:when test="${productPage || wishl i stDi spl ayPage || prodComparePage || 
storeAvai 1 Page || storeDetail Page || shoppi ngcartDi spl ayPage || productRevi ewPage} "> 
<%-- Product display page which is reached by clicking a product on the search page 
--%> 


12. Locate the code shown in Example 5-131. 

Example 5-131 Code example 

<c:when test="${wi shl i stDi spl ayPage || prodComparePage || shoppi ngcartDi spl ayPage} "> 

<c:if test="$ { wi shl i stDi spl ayPage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"><fmt:message key="BCT_WISHLIST" 
bundl e="${storeText} " /x/span> 

</c:if> 

<c : i f test="${ shoppi ngcartDi spl ayPage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"xfmt:message key="BCT_SHOPPINGCART" 
bundl e="${storeText} " /x/span> 

</c:if> 

<c:if test="${ prodComparePage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 
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<span class="current_page"><fmt:message key="BCT_PROD_COMPARE_LIST" 
bundle="${storeText} " /></span> 

</c : i f > 

</c:when> 


1 3. Update the code from Example 5-131 to look like the code in Example 5-1 32. 
The inserted code is highlighted in bold. 

Example 5- 1 32 Code example 

<c:when test="${wi shl istDisplayPage || prodComparePage || shoppingcartDisplayPage || 
productReviewPage} "> 

<c:if test="$ {wi shl istDisplayPage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"><fmt:message key="BCT_WISHLIST" 
bundl e="${storeText} " /x/span> 

</c : i f > 

<c : i f test="${shoppi ngcartDi spl ayPage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"xfmt:message key="BCT_SHOPPINGCART" 
bundl e="${storeText} " /x/span> 

</c : i f > 

<c:if test="${prodComparePage}"> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"xfmt:message key="BCT_PROD_COMPARE_LIST" 
bundl e="${storeText} " /x/span> 

</c : i f > 

<c : i f test="${productRevi ewLi st Page} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText}" /> 

<span class="current_page"><fmt:message key="REVIEW_LIST_TITLE" 
bundl e="${storeText}" /x/span> 

</c : i f > 

<c: if test="${productReviewDetail sPage}"> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText}" /> 

<a href="${fn:escapeXml (reviewListUrl)}"xf m t message key="REVIEW_LIST_TITLE" 
bundl e="${storeText}" /></&> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText}" /> 

<span class="current_page"><fmt:message key="REVIEW_DETAILS_TITLE" 
bundl e="${storeText}" /x/span> 

</ c : i f > 

<c: if test="${productReviewPostPage}"> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText}" /> 

<a href="${fn:escapeXml (reviewListUrl)}"xf m t message key="REVIEW_LIST_TITLE" 
bundl e="${storeText}" /></&> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText}" /> 
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<span class="current_page"><fmt:message key="WRITE_REVIEW_TITLE" 
bundl e="${storeText}" /></span> 

</c:if> 

</c:when> 


14. Locate the code shown in Example 5-133. 

Example 5- 1 33 Code example 

<c:when test="${categoryPage || productPage || wishl istDisplayPage || prodComparePage 
|| storeAvailPage || storeDetai 1 Page || shoppingcartDisplayPage}"> 


15. Update the code from Example 5-133 to look like the code in Example 5-134. 
The inserted code is highlighted in bold. 

Example 5-134 Code example 

<c:when test="${categoryPage || productPage || wishl istDisplayPage || prodComparePage 
|| storeAvailPage || storeDetai 1 Page || shoppingcartDisplayPage || 

productReviewPage} "> 


16. Locate the code shown in Example 5-135. 

Example 5-135 Code example 

<c : i f test="${shoppi ngcartDi spl ayPage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"><fmt:message key="BCT_SHOPPINGCART" 
bundle="${storeText} " /></span> 

</c : i f > 

<c:if test="${storeAvai 1 Page} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"><c:out value="${physicalStore.description[0] .name}" 
/></span> 

</ c : i f > 


1 7. Update the code from Example 5-135 to look like the code in Example 5-1 36. 
The inserted code is highlighted in bold. 

Example 5-136 Code example 

<c : i f test="${shoppi ngcartDi spl ayPage} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"><fmt:message key="BCT_SHOPPINGCART" 
bundle="${storeText} " /x/span> 

</c:if> 

<c : i f test="${productRevi ewLi st Page} "> 
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<fmt:message key="DIVIDING_BAR" bundle="${storeText}" /> 

<span class="current_page"><fmt:message key="REVIEW_LIST_TITLE" 
bundle="${storeText}" /></span> 

</c:if> 

<c : i f test="${productRevi ewDetai 1 sPage}"> 

<fmt:message key="DIVIDING_BAR" bundle="${storeText}" /> 

<a href="${fn:escapeXml (reviewListUrl)}"><fmt:message key="REVIEW_LIST_TITLE" 
bundle="${storeText}" /></a> 

<fmt:message key="DIVIDING_BAR" bundle="${storeText}" /> 

<span class="current_page"><fmt:message key="REVIEW_DETAILS_TITLE" 
bundle="${storeText}" /></span> 

</c:if> 

<c:if test="${productReviewPostPage}"> 

<fmt:message key="DIVIDING_BAR" bundle="${storeText}" /> 

<a href="${fn:escapeXml (reviewListUrl)}"><fmt:message key="REVIEW_LIST_TITLE" 
bundle="${storeText}" /></a> 

<fmt:message key="DIVIDING_BAR" bundle="${storeText}" /> 

<span class="current_page"><fint:message key="WRITE_REVIEW_TITLE" 
bundle="${storeText}" /x/span> 

</c:if> 

<c : i f test="${storeAvai 1 Page} "> 

<fmt:message key="DIVIDING_BAR" bundl e="${storeText} " /> 

<span class="current_page"xc:out value="${physicalStore.description[0] .name}" 
/x/span> 

</c : i f > 


18. Save and close the file. 

Modify the cascading style sheets 

To show the new and changed pages correctly, you need to modify the standard 
cascading style sheet (CSS) file for Madisons Mobile Starter Store: 

1 . In the Java EE perspective of IBM WebSphere Commerce V7 Developer 
Edition, expand and double-click Stores 0 WebContent 0 Madisons 0 
mobile 0 css 0 common1_1.css. 
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2. The commonl_l.css file opens in the CSS editor as shown in Figure 5-53. 


■S commonl.l.css S3 

Preview with: | <sample html file> ^ 

Selected Style 

Style of body 

Standard HTML Elements 


Heading 1 Heading 1 

Heading 2 Heading 2 

Heading 3 Heading 3 
leading 4 Heading 4 


lulleted Li 
lulleted Li: 
lulleted Li 
lulleted Li: 
Ordered List 
Ordered List 

1. Ordered Li: 

2. Ordered Li: 


color: #3b44S3 ; 
font: 12px eerdan 




argin: 6px 0 lOpx 


Figure 5-53 The common 1_ l.css file opened in the CSS editor 


3. Add the CSS styles shown in Example 5-137 to the bottom of the 
common 1_1. css file. 

4. Save and close the file by pressing Ctrl+S and then Ctrl+W. 
Example 5-137 New styles for common 1_ 1 . css 

/* Social Commerce Styling */ 

/* Global Product Review Styles */ 
divfreviews p, 
di v#review_detail s p, 
di v#write_review p { 
margin-top: 9px; 
margin-bottom: 6px; 
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div#review_details div.paging_control , 
di v#write_review div.paging_control { 
margin-top: lOpx; 


/* */ 

/* Reviews */ 

divfreviews di v.sort_by_control { 
border-top: lpx solid #c6d0dc; 
border-bottom: lpx solid #c6d0dc; 
margin: 9px 0; padding: 5px 0; 

} 


di v.sort_by_control span.current_sort { 
font-weight: bold; 
padding-right: 5px; 


/* */ 

/* Review Details */ 
div#review_details di v.review_info { 
border-top: lpx solid #c6d0dc; 
margin: 9px 0; padding: 5px 0; 

} 


div.reviewjinfo a.user_image { 
float: left; 

} 


div.reviewjinfo ul { 
margin-left: 50px; 

} 


div.review_info ul li { 
padding: lpx 0; 


/* */ 

/* Write review */ 
di v#write_review form { 

border-top: lpx solid #c6d0dc; 
margin: 9px 0; 
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di v#write_review form p. rating { 
margin-left: 8px; 
margin-top: 3px; 

} 

di v#write_review div.textarea_container { 
margin-bottom: 8px; 

} 

di v#write_review div.input_container input, 

di v#write_review div.textarea_container textarea { 
width: 98%; 

} 

/* */ 


Amend the struts configuration file 

You need to amend the struts configuration file so that it caters to the new pages 
and command. You need to add global forwards for the new pages and action 
mappings for the pages and the command. To add the global forwards for the 
new pages: 

1 . In the Java EE perspective of IBM WebSphere Commerce V7 Developer 
Edition, expand and right-click Stores 0 WebContent 0 WEB-INF 0 
struts-config-ext.xml. 

2. In the context menu, select Open With 0 XML Editor. 

3. The struts-config-ext.xml file opens in an XML editor. Select the Source 
tab if the editor opens in the Design view. 

4. Locate the beginning of the global forwards section, as signified by the 
following line: 

<global-forwards> 

5. Insert the forwards shown in Example 5-1 38 after this line. 

Example 5-138 Global forwards for struts-config-ext.xml to support mobile ratings and reviews 

<forward cl assName="com. i bm. commerce. struts . ECActionForward" 
name="mProductReviewsView/10051" 

path="/mobi 1 e/Shoppi ngArea/Catal ogSection/Revi ewSubsection/ProductRevi ewLi st . jsp" /> 

<forward cl assName="com. i bm. commerce. struts . ECActionForward" 
name="mReviewDetai 1 s/10051" 

path="/mobil e/Shoppi ngArea/Catal ogSection/ReviewSubsection/ProductReviewDetai Is. jsp" 
/> 
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<forward cl assName="com. i bm. commerce. struts . ECActionForward" 
name="mPostReviews View/ 10051" 

path="/mobile/ShoppingArea/CatalogSection/ReviewSubsection/PostReview. jsp"/> 


Note: The forwards in Example 5-138 contain the store ID for the 
Madisons starter store. In our example, the store ID was 10051 . Substitute 
your value for the Madisons starter store ID when adding the global 
forwards, as appropriate. 


6. Locate the beginning of the action mappings by locating the following line: 
<acti on-mappi ngs type="com. i bm. commerce. struts . ECActi onMappi ng"> 

7. Add the action mappings from Example 5-1 39 after this line. 

Example 5- 1 39 Action mappings for struts-config-ext.xml to support mobile ratings and reviews 
<action 

path="/mProductReviewsView" type="com.ibm. commerce. struts. BaseActi on" /> 
<action 

path="/mReviewDetail s" type="com.ibm. commerce. struts. BaseActi on" /> 

<action 

path="/mPostReviewsView" type="com. i bm. commerce. struts. BaseActi on" /> 

<action 

parameter "com . i bm . i tso . commerce . soccom. commands . PostRevi ewCmd" 

path="/PostReview" type="com.ibm. commerce. struts. BaseActi on" /> 


8. Save and close the file by pressing Ctrl+S and then Ctrl+W. 

Configure access control 

The IBM WebSphere Commerce access control framework works on an explicit 
model in which a resource is accessible to a given user only if the access is 
specifically permitted. In this section, you configure the access control for the 
new pages and the new command. 

To configure the access control policies, you need to complete the following main 
steps: 

1 . Create the access control policy file for the new command and views 

2. Load the access control policies for the new command and views 
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Create the access control policy file for the new command and 
views 


To create the access control policy file: 

1 . Open your favorite text editor. We opened Notepad by selecting Start 0 
Programs 0 Accessories 0 Notepad. 

2. Enter the XML document shown in Example 5-140 into the text editor. 

Example 5-140 XML file for acpload to configure access control for mobile ratings and reviews 

<?xml version="1.0" encoding="IS0-8859-l" standal one="no" ?> 

< ! DOCTYPE Policies SYSTEM " . ./dtd/accesscontrol pol i cies .dtd"> 

<Pol icies> 

<Action 

Name="mProductRevi ewsVi ew" 

CommandName="mProductReviewsView" 

/> 

<Action 

Name="mReviewDetai Is" 

CommandName="mReviewDetai Is" 

/> 

<Action 

Name="mPostRevi ewsVi ew" 

CommandName="mPostReviewsView" 

/> 

<Action 

Name= "com. ibm.itso. commerce. soccom. commands. PostReviewCmd" 

CommandName=" com. ibm. i tso. commerce. soccom. commands. PostReviewCmd" /> 

<ResourceCategory 

Name= "com .ibm.itso. commerce .soccom . commands . PostRevi ewCmdResourceCategory " 
ResourceBeanClass= "com. ibm. i tso. commerce. soccom. commands. PostReviewCmd"> 
<ResourceAction Name="ExecuteCommand"/> 

</ResourceCategory> 

<ResourceGroup Name="Al ISiteUserCmdResourceGroup" 

OwnerID="RootOrganization"> 

<ResourceGroupResource 

Name=" com. ibm.itso. commerce. soccom. commands. PostRevi ewCmdResourceCategory "/> 
</ResourceGroup> 
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<ActionGroup Name="Madi sonsAl 1 UsersViews" OwnerID="RootOrganization"> 
<ActionGroupAction Name="mProductReviewsView"/> 

<ActionGroupAction Name="mReviewDetai 1 s"/> 

<ActionGroupAction Name="mPostReviewsView"/> 

<ActionGroupAction Name=" com. ibm. i tso. commerce. soccom. commands. PostReviewCmd"/> 
</ActionGroup> 

</Policies> 


3. Save the file as NC_Home\m\ \pol icies\xml \mobi le-soccom-acp.xml . In our 
example, we saved the file as: 

C:\IBM\WCDE_ENT70\xml \pol i cies\xml \mobi 1 e-soccom-acp.xml 

4. Close the text editor. 

Load the access control policies for the new command and views 

Because you created the access control policy file and placed it in the location to 
be picked up by IBM WebSphere Commerce, you can load these policies into the 
development database. 


Important: The default database provider for IBM WebSphere Commerce V7 
Developer Edition is IBM Cloudscape. IBM Cloudscape allows only one 
connection to the database at a time. As such, it is not possible to load the 
access control policies while the server is running. 

If you use IBM Cloudscape for the database, you need to stop the server while 
the access control policies are loaded and then restart the server afterwards. 


To load the custom access control policies: 

1 . Open a command line window by selecting Start 0 Programs 0 
Accessories 0 Command Prompt. 

2. Change to the WC_Home \ bi n directory, where k/C_Home is the installation 
directory of IBM WebSphere Commerce V7 Developer Edition. For example, 
we entered the following command: 

cd \IBM\WCDE_ENT70\bin 

3. Run the following command to transform the XML and load the new policies: 
acpload mobi le-soccom-acp.xml 

Note: If you are not using IBM Cloudscape as the database manager, you 
need to specify connection parameters on the acpload command line. Run 
acpload without any parameters to learn the syntax of the command. 
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4. The acpload command runs for a while. Example 5-141 shows the expected 
output. 

Example 5-141 Expected output from acpload 

C:\IBM\WCDE_ENT70\bi n>acpl oad mobi 1 e-shi ppi ng-acp.xml 
Running XMLTransform. . . 

Running Id Resolver. . . 

Running MassLoader. . . 

Examine acpload.log to ensure that everything completed successfully. 
C:\IBM\WCDE_ENT70\bi n> 


5. Because the output from acpload does not notify you of errors that it 

encounters, you need to inspect the acpl oad . 1 og file for errors, as stated in 
the console output from acpload. 

The acpl oad . 1 og file is located in the MC_Home \ logs directory. In our example, 
the file was located in the following directory: 

C:\IBM\WCDE_ENT70\logs 

The output in acpl oad . 1 og should look similar to the output shown in 
Example 5-142. 

Example 5- 1 42 Output in acpload. log from a successful load 

Running XMLTransform... 

Running Id Resolver. . . 

Running MassLoader... 


If you are using IBM Cloudscape and have not stopped the server, 
acpl oad . 1 og contains an error similar to the one shown in Example 5-22. Stop 
the application that is using the database (most likely the test server) and 
retry step 3 on page 396. 

Define localized strings for pages 

The final step that you need to complete to test the modifications is to add the 

localized texts that are referenced from the JSP code: 

1 . In the Enterprise Explorer, expand and double-click Stores 0 
Java Resources: JavaSource 0 Madisons. mobile 0 
storetext.properties. 

2. The file opens. Insert the properties from Example 5-143, and press Ctrl+S 
and then Ctrl+W to save and close the file. 
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Example 5- 143 The storetext.properties file 
##### Social Commerce ##### 

RATING_OVERALL_TITLE = Overall Rating 
RATING_READ_REVIEWS_LINK = Read Reviews 

RATING_OVERALL_ERROR = An error occurred while retrieving rating 
RATING_OVERALL_NONE = This item has not been rated. \ 

Be the first to write a review 

WRITE_REVIEW_REGISTER_OR_LOGIN = <a href="{0}" title="Register">\ 
Register</a> to create a new review or <a href="{l}" \ 
title="Sign in">Sign in</a> in if you are already a member. 

REVIEW_LIST_TITLE = Reviews 
REVIEW_LIST_WRITE_REVIEW = Write a review 
REVIEW_LIST_SORT_BY = Sort by: 

REVIEW_LIST_SORT_BY_RATING = Highest rating 
REVIEW_LIST_SORT_BY_NEWEST = Newest post 
REVIEW_LIST_PAGE = Page {0}/{ 1} 

REVIEW_LIST_PAGE_PREV = Previous 
REVIEW_LIST_PAGE_PREV_TITLE = Previous page 
REVIEW_LIST_PAGE_NEXT = Next 
REVIEW_LIST_PAGE_NEXT_TITLE = Next page 
REVIEW_OVERVIEW_INFO = By {0} on {1}. 

REV I EW_READ_REV I EW = Read Review 

REVIEW_DETAILS_TITLE = Review details 

REVIEW_DATEFORMAT = M/d/yy h:mma 

REV I EW_WRI TE_REV I EW = Write a review 

RE V I EW_D ETAI LS_N EXT = Next review 

REV I EW_DETAI LS_PREV I OUS = Previous review 

REV I EW_DETAI LS_BACK = Back to reviews 

PROD_CMPR_RATING = Product Rating 
PRO D_CM P R_RAT I N G_N ONE = (0 reviews) 

PRO D_CM P R_RAT I N G_0 N E = (1 review) 

PRO D_CM P R_RAT I N G_MU LT I P L E = ({0} reviews) 

WRITE_REVIEW_TITLE = Write review 
WRITE_REVIEW = Write a review 
REQU I RED_FI ELDS = Denoted required fields 
SELECT_REVIEW_RATING = Select rating 
REVIEW_RATING_0 = No rating 
REVIEW_RATING_1 = Poor (one star) 

REVIEW_RATING_2 = Could be better (two stars) 
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REV I EW_RAT I NG_3 = OK (three stars) 

REVIEW_RATING_4 = Good quality (four stars) 

REVIEW_RATING_5 = Brilliant (five stars) 

ENTER_REVIEW_TITLE = Enter a title 
ENTER_REVIEW_COMMENTS = Comments 

WRITE_REVIEW_DELAY = Content created on this site is subject to a \ 
delay in viewing due to administrative reasons. 
WRITE_REVIEW_ERROR = Review could not be created. 

REVIEW_SUBMIT = Submit 
REVIEW_CANCEL = Cancel 


5.6 Analytics 

In this section, we discuss how to use Web Analytics in WebSphere Commerce. 
We also provide a sample of how to implement page view analysis for the 
Madisons Mobile Starter Store. 

5.6.1 Coremetrics Web Analytics for WebSphere Commerce 

The Coremetrics enhanced Web Analytics for WebSphere Commerce provides 
tools that simplify the process of setting up the site to take advantage of the 
industry-leading, hosted Web Analytics solution. These tools include a 
framework that simplifies site configuration, including tagging JSP files so that 
they provide appropriate analytics information to Coremetrics. You implement the 
framework as a tag library that is designed specifically to act as an intermediary 
layer between WebSphere Commerce and Coremetrics. 

To take advantage of Coremetrics for IBM WebSphere Commerce, you must 
install Coremetrics enhanced Web Analytics for WebSphere Commerce and 
establish a contract with Coremetrics to collect data and to generate and host the 
resulting reports. The following default reports are available in Coremetrics for 
WebSphere Commerce: 

► WebSphere Commerce Campaigns Report 

► E-Marketing Spot Report 

► Marketing Experimentation Summary 

► Promotions Summary 

► Business-to-business Contracts 

► Sales Center 

- CSR and Team Summaries 

- CSR Quotas to Orders Conversion Rate 
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You can view these reports by selecting the WebSphere Commerce menu after 
you have logged on to the Coremetrics site, as showed in Figure 5-54. 



Figure 5-54 Access WebSphere Commerce reports from Coremetrics Web site 2 

With IBM WebSphere Commerce V7, to enable the Coremetrics Web Analytics 
takes only a few steps: 

1 . Obtain your Coremetrics client ID and Coremetrics JavaScript libraries from 
Coremetrics. 

2. Update your WebSphere Commerce application in WebSphere Application 
Server administration console. Select Replace or add a single file to add the 
JavaScript library to the Store Web module path, as shown in Figure 5-55 on 
page 401 . 

For more information about updating an application, refer to: 

http : //pub! ib. boulder. ibm. com/i nfocenter/was inf o/v7r0/index. jsp 


2 Screen capture courtesy of Coremetrics, Inc. 
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3. Modify the biConfig. xml file shown in Example 5-144. 

Example 5 - 1 44 The biConfig. xml sample file 

<?xml version="1.0" encoding="UTF-8"?> 
<BIConfiguration> 

<biproviders> 

<bi provider name="coremetri cs"> 

<header> 
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<! [CDATA[<script 1 anguage="JavaScri ptl . 1" 
type="text/JavaScri pt"> 

<! -- 

]]> 

</header> 

<footer> 

<! [CDATA[ 

//--> 

</script>]]> 

</footer> 

</biprovider> 

</biproviders> 

<stores> 

<store storeId="YourStoreId" biprovider="coremetrics" 
enabled="true" debug="true"> 

<cl ientid>YourCl ientld</cl ientid> 

<instrumentation> 

<! [CDATA[ 

<script language="JavaScriptl.l" type="text/JavaScript" 
src="/wcsstore/coremetrics/v40/eluminate. js"></script> 
<script language="JavaScriptl.l" type="text/JavaScript" 
src="/wcsstore/coremetrics/v40/techprops. js"></script> 
<script language="JavaScriptl.l" type="text/JavaScript" 
src="/wcsstore/coremetri cs/cmdatataguti 1 s . js"x/scri pt> 
<script language="JavaScriptl.l" type="text/JavaScript"> 
cmSetProduction() ; 

</script>]]> 

</instrumentation> 

</store> 

</stores> 

</BIConfiguration> 


Note: You need to change the YouCl ientld parameter to the client ID that 
you obtained from Coremetrics. You also need to change the YourStoreld 
parameter to the real store ID of the WebSphere Commerce store. Finally, 
you must uncomment the cmSetProducti on () line, or you cannot get your 
results from the Coremetrics Web site. 
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4. Log on to WebSphere Commerce Accelerator tool, and select the menu 
Store 0 Change Flow to enable the Coremetrics Web Analytics, as shown in 
Figure 5-56. Select Analytics in the left panel, and then check Enable 
Analytics Integration. 



Figure 5-56 Enable Coremetrics Analytics in WebSphere Commerce Accelerator 3 

5. Run the WebSphere Commerce scenarios. The Coremetrics JSP tags in 
WebSphere Commerce JSP pages collect the data and send it to 
Coremetrics for Analytics. 

6. Log on to the Coremetrics Web sites to check the analytics results. 
Coremetrics analyzes the data that it receives every night. You can log on to 
and view the analytics results one day after they are collected. Figure 5-57 
shows an example merchandising report of WebSphere Commerce. 


3~ 


Screen capture courtesy of Coremetrics, Inc. 
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Figure 5-57 Merchandising Report for WebSphere Commerce 


5.6.2 Implementing mobile analytics 

We give an sample implementation of how to do page view analytics in the 
Madisons Mobile Starter Store in WebSphere Commerce. 

Overview of mobile analytics 

By default, Web analytics for WebSphere Commerce Madisons Mobile Starter 
Store are not enabled in WebSphere Commerce V7. To exploit the business 
intelligence feature of Coremetrics, you need to take extra steps. 

There are different types of pervasive devices that shoppers can use to access 
the WebSphere Commerce Madisons Mobile Starter Store. For the devices that 
do not support JavaScript, Coremetrics supplies an image request approach to 
collect the analytics data. Example 5-145 shows a sample for the image request. 
The parameters highlighted in bold are Coremetrics parameters. 

Example 5-145 A sample image request for devices that do not support JavaScript 


src= 

"/img?url =http%3A%2F%2Fwww.madisonsmobile.ibm.com%2FcreatellID.cfm&amp;t 
tl=l"> 

<img alt="" class="coremetrics" 
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src= "http://www.madisonsmobile.ibm. com/el uminate?tid=l&amp;ci=YourCl ien 
t Id&amp ; st=1209488131717&amp; ul =http%3A//www.madi sonsmobi 1 e . i bm . com&amp 
; pi =MOBI LE%3A%20Home%20Page&amp ; vnl=4 . 0 . 18&amp ; vn2=e3 . l&amp ; cg=MOBI LE%2 
OPAGES"> 


For more detailed information about the image request approach, refer to: 
http : //www . coremetri cs . com/ 

For devices that do not support the cookies, Coremetrics supplies additional 
parameters. Refer to Coremetrics for more information if you want to support 
these types of devices. 

For the devices that support JavaScript and cookies, you can use the 
Coremetrics JSP tags that are supplied by WebSphere Commerce to collect the 
data. 

You can use the following Coremetrics JSP tags in mobile JSP files: 

► <cm:pageview> tag 

You can use the <cm: pagevi ew> tag to collect the data for Web pages that are 
viewed by online shoppers. For information about how to use this tag and its 
parameters, refer to: 

http : //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?top 
i c=/com. i bm. commerce. Coremetri cs .doc/ref s/rmtusepgvw. htm 

► <cm:order> tag 

You can use the <cm:order> tag to collect the order data that is placed by the 
online shopper in the WebSphere Commerce online store, which must be 
used in the order confirmation page. For information about how to use this tag 
and its parameters, refer to: 

http : //publ i b . boul der . i bm.com/infocenter/wchel p/v7rOmO/topi c/com. i bm 
. commerce. Coremetrics. doc/concepts/cmttagl ib. htm 

► <cm:cart>tag 

You can use the <cm:cart> tag to collect the content information of the 
current shopping cart of an online shopper. For information about how to use 
this tag and its parameters, refer to: 

http : //publ i b . boul der . i bm.com/infocenter/wchel p/v7rOmO/i ndex . jsp?top 
i c=/com. i bm. commerce . Coremetri cs .doc/ref s/rmtusecart . htm 
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► <cm:product> tag 

You can use the <cm:product> tag to collect the product related information. 
For information about how to use this tag and its parameters, refer to: 
http : //publ i b . boul der . i bm.com/infocenter/wchel p/v7rOmO/i ndex . jsp?top 
i c=/com. i bm. commerce . Coremetri cs .doc/ref s/rmtuseprdt . htm 

► <cm: regi strati on> tag 

You can use the <cm: regi strati on> tag to collect the user registration 
information. For information about how to use this tag and its parameters, 
refer to: 

http: //publ ib.boulder.ibm.com/infocenter/wchel p/v7rOmO/index. jsp?top 
i c=/com. i bm. commerce . Coremetri cs .doc/ref s/rmtusereg . htm 

► <cm:campurl> tag 

You can use the <cm:campurl> tag to collect the campaign data, which is 
included in the e-Marketing Spot. For information about how to use this tag 
and its parameters, refer to: 

http : //publ i b . boul der . i bm.com/infocenter/wchel p/v7rOmO/i ndex . jsp?top 
i c=/com. i bm . commerce . Coremetri cs . doc/ref s/rmtusecmp . htm 

► <cm:contenturl> tag 

You can use the <cm:contenturl> tag to collect the content related 
information in a content spot. For information about how to use this tag and its 
parameters, refer to: 

http: //publ ib.boulder.ibm.com/infocenter/wchel p/v7rOmO/index. jsp?top 
i c=/com. i bm. commerce . Coremetri cs .doc/ref s/rmtusecntspt . htm 

► <cm:generic> tag 

The <cm:generi c> tag is available for use as a pass-through tag to 
communicate additional information about site usage. You can use this tag as 
a customization tool or to forward information to Coremetrics tags that are not 
currently supported in the tag library that is provided in Coremetrics for IBM 
WebSphere Commerce. For information about how to use this tag and its 
parameters, refer to: 

http : //publ i b . boul der . i bm.com/infocenter/wchel p/v7rOmO/i ndex . jsp?top 
i c=/com. i bm. commerce . Coremetri cs .doc/ref s/rmttaggeneri c . htm 
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Sample mobile analytics implementation 

In this sample, we modify the current WebSphere Commerce Madisons Mobile 
Starter Store JSPs to add Coremetrics JSP tags to do page view analytics with 
Coremetrics. After the data is sent to Coremetrics and mined, you can log on to 
the Coremetrics Web site to view the report for the mobile store: 
https : //wel come . coremetri cs . com/marketforce/Logi n?auth=2 
To complete this sample: 

1 . Open the developer’s toolkit for IBM WebSphere Commerce V7, as shown in 
Figure 5-58. 



Figure 5-58 WebSphere Commerce 1/7 toolkit main Ul 
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2. Navigate to the Web project Store, and copy the Coremetrics JavaScript 
library to the Stores/WebContent directory, as shown in Figure 5-59. 



Figure 5-59 Copy the Coremetrics JavaScript library to the Store project 

Coremetrics has three JavaScript files: 

- el uminate. js 

- techprops.js 

- cmdatatagutils.js 

3. Update the biConfig.xml file in the J/CD£_WOM£/workspaces/xml/config/bi 
directory, as shown in Example 5-144 on page 401. 

Note: WCDE_H0ME is the installation directory for the WebSphere Commerce 
toolkit (for example F:\IBM\WCDE_INT70). 

4. Make a backup of the mobi leHome.jsp file. 
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5. Locate the following line of code in the mobileHome.jsp file: 

<%@ taglib uri=" http: //commerce. ibm.com/foundation" prefix="wcf" %> 

6. Then, insert the following lines of codes after this line: 

<%-- test coremetrics for mobile --%> 

<%@ taglib uri="http://commerce. ibm.com/coremetrics" prefix="cm" %> 
<%-- test coremetrics for mobile --%> 

This code imports and declares the Coremetrics tag library of WebSphere 
Commerce. 

7. Locate the HTML </body> tag in the mobi leHome. jsp file, and insert the 
following lines of code before this tag: 

<%-- test mobile coremetrics begin --%> 

<cm:pageview category="SAW912 Mobile" /> 

<%-- test mobile coremetrics end --%> 

We inserted the pageview tag into this page. We set the category parameter 
to SAW912 Mobi 1 e, which can be used by Coremetrics to organize the content 
categories report. Here, we use it as the category to better organize the 
sample page view results. 

All our sample page views are in the same category of SAW912 Mobile. We 
use another import parameter, pagename, for the pageview tag to specify the 
name of the page. If no value is set, the default is the page title. We use the 
default value. 

Example 5-146 is the complete mobi leHome. jsp file after our modification. 
Example 5-146 The mobileHome.jsp file after modification 


Licensed Materials - Property of IBM 
WebSphere Commerce 

(C) Copyright IBM Corp . 2008, 2009 All Rights Reserved. 

US Government Users Restricted Rights - Use, duplication or 
disclosure restricted by GSA ADP Schedule Contract with 
IBM Corp . 


***** 

* This JSP displays the mobile store home page 
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--%> 


<!-- BEGIN mobileHome.isfi --> 

<%@ taglib uri="http: //java. sun.com/jsp/jstl/fmt" prefi x="fmt" %> 

<%@ taglib uri="http: //java. sun.com/jsp/jstl/functions" prefi x="fn" %> 
<%@ taglib uri="http: //java. sun.com/jsp/jstl/core" prefix="c" %> 

<%@ taglib uri="http: //commerce. ibm.com/base" prefi x="wcbase" %> 

<%@ taglib uri="http: //commerce. ibm.com/foundation" prefi x="wcf" %> 
<%-- test coremetrics for mobile — %> 

<%@ taglib uri="http://commerce. ibm.com/coremetrics" prefix="cm" %> 
<%-- test coremetrics for mobile — %> 

<%@ include file=" .. /include/parameters. jspf" %> 

<%@ include fUe="include/JSTLEnvironmentSetup.jspf" %> 

<c:set var ="storeId" val ue="${WCParam.storeId} " /> 

<c:set var ="catalogId" value="${WCParam.catalogId}" /> 

<%-- Required variable for breadcrumb support --%> 

<c:set var="mobileIndex" valu e="true" scop e="page" /> 

<! DOCTYPE html PUBLIC "-//WAPFORUM//DTD XHTML Mobile 1.2//EN" 

" http: //www. openmobi leal liance.org/tech/DTD/xhtml -mobi lel2.dtd"> 

<html xml ns ="http: / /www. w3.org/1999/xhtml " 1 ang="${shortLocal e} " 
xml :lang="${shortLocale}"> 

<head> 

<ti tle><fmt:message key="HOME" bundl e="${storeText} "/> - <c:out 
value="${storeName}"/x/title> 

<meta http-equi v= "content- type" content =" application /xhtml-vxml" 

/> 

<meta http-equi v=" cache-control " cor\tent="max-age=300" /> 

<meta nme="viewport" conter\t="width=device-width, 
initial-scale=1.0, user-scalable=no" /> 

<1 i nk rel ="stylesheet" typ e="text/css" href="${cssPath} " /> 
</head> 

<body> 

<div id= "wrapper "> 

<%@ include file=" . / include / HeaderDisplay . jspf " %> 

<%@ include fil e=“ . /include /sear chHeader. jspf" %> 


<%— 

<div id="index_banner" cl ass="banner"> 
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<img src="<c:out 

val ue="${jspStoreImgDir} " /> mobi 1 e / imaaes/i ndex_banner . i pa " width="320" 
height="75" border="0" al t="Comfort - Relax in luxury" /> 

</di v> 

<div class="text_container"> 

<p>Style your home with these great chairs. </p> 

<p><span class="bul let">&#187; </span><a href ="#" 
title="More Info">More Info</a></p> 

</di v> 

--%> 

<%out.flush();%> 

<c: import 

ur’\ = "${js<pStoreDir}mobile/Snippets/Marl<eting/ESpot/ContentAreaESpot.jsp 
"> 

<c:param name= "emsName" val ue="MobileHomePage" /> 

<c:param nme="catalogId" value="${WCParam.catalogId}" /> 
</c:import> 

<%out.fl ush() ;%> 

<%@ include fi]e="include/BrowseDepartments.jspf" %> 

<%@ include fil e="include/storeOptions.jspf" %> 

<%out.fl ush() ;%> 

<c: import 

url ="${ jspStoreDirJmobiZe/ Snippets /Mar keting / ESpot / FeaturedProductsESpo 
t.jsp"> 

<c:param name= "emsName" 
val ue="MobileHomePageFeaturedProducts" /> 

<c:param name="cataZog7c/" value="${WCParam.catalogId}" /> 
<c:param nam e="align" value="W" /> 

</c:import> 

<%out.fl ush() ;%> 

<%@ include fUe="include/FooterDisplay.jspf" %> 

</di v> 

<%-- test mobile coremetrics begin --%> 

<cm:pageview category="SAW912 Mobile" /> 

<%-- test mobile coremetrics end --%> 

</body> 

</html> 

<!-- END mobileHome.jsg --> 


When the shoppers browses this page from a mobile device, data is collected 
and sent to the Coremetrics server. 
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8. Repeat step 4 on page 408 through step 7 on page 409 and add the 
<cm:pageview> tag to the following JSP pages. 

- ProductDisplay.jsp 

- CategoriesDisplay.jsp 

- OrderBi 1 1 i ngAddressSel ecti on . j sp 

- OrderBillingDetails.jsp 

- OrderPaymentDetails.jsp 

- OrderConfirmationDisplay.jsp 

- OrderDetails.jsp 

- OrderSummaryDisplay.jsp 

- OrderltemDisplay.jsp 

- StoreDetails.jsp 

- StoreLocator.jsp 

- StoreMap.jsp 
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9. Go to the Madisons Mobile Starter Store home page with your mobile device. 
Figure 5-60 shows the home page in a Windows mobile simulator. 



Figure 5-60 Madisons Mobile Starter Store home page 
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Scroll to the bottom of the home page to see the following line as shown in 
Figure 5-61: 

cmCreatePageviewTag(document. title, "SAW912 Mobile", null, null, 
" 10101 "); 

This line of code was added by the <cm:pageview> tag, which collects data 
and sends the data to the Coremetrics server. 



Figure 5-61 Mobile Store Home Page bottom 


10. Browse more pages of the mobile store or place an order. You can refer to 
4.2.2, “BOPIS in Madisons Starter Store” on page 135 for more detailed steps 
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for placing an order. There is only slight difference between the Madisons 
Starter Store shopping flow and Madisons Mobile Starter Store shopping flow. 
1 1 .Log on to the Coremetrics Web site with your client ID, user name, and 
password, as shown in Figure 5-62. 


CORE METRICS ' 1 


Welcome to Coremetrics 
for IBM® WebSphere Commerce® 


Client ID YourClientld 


User Name YourUserName 

Password •• 


□ 


| English (US) B1 


Login 


D 


Forgot Password or Locked Account? 
□ Remember Client ID and User Name 


Figure 5-62 Coremetrics login 4 


Note: You need to perform this step one day after you complete the 
shopping flows in the Madisons Mobile Starter Store. It takes one day for 
Coremetrics to mine the data and generate the reports. For more 
information about working with Coremetrics analytics, refer to: 

http : //www . coremetri cs . com/ 


4 Screen capture courtesy of Coremetrics, Inc. 
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12. In the Coremetrics home page, default reports are displayed. We do not use 
these reports, so you can click Content Analysis menu, as shown in 
Figure 5-63. 



Figure 5-63 Select Content Analysis menu in Coremetrics home 5 


5 Screen capture courtesy of Coremetrics, Inc. 
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13. Select Content Categories menu item, the Coremetrics report of content 
categories is displayed, as shown in Figure 5-64. 



Figure 5-64 Content categories report, collapsed? 

14. Expand the category of NO CATEGORY ASSIGNED, as shown in 
Figure 5-65. The tagged category of SAW912 Mobile is displayed. 


Content Categories « 


Full Report 1 Trend Rows 0 selected (10 m 


I Open Settings I 


Category 

Page ~ 

Page 

Views 

Entry 

Departure 

Sessions 

Sales 

Orders 

Q H NO CATEGORY ASSIGNED 



6 

6 

$0.00 


9 

H SAW912 MOBILE 


38 5 

5 

5 

$0.00 


9 

H NO CATEGORY ASSIGNED 


4 0 

1 

1 

$0.00 


9 

B HOME 


2 1 

0 

1 

$0.00 



Figure 5-65 Content categories report with SAW912 Mobile collapsed 7 


6 Screen capture courtesy of Coremetrics, Inc. 

7 Screen capture courtesy of Coremetrics, Inc. 
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15. Expand the SAW912 Mobile category. The detailed report contains all the 
information about the pages the shopper viewed, as shown in Figure 5-66. 


Category 

Page 


Entry 

Departure 

Sessions 

B NO CATEGORY ASSIGNED 

44 6 6 

9 0 SAW912 MOBILE 

38 5 5 


SAW912 MOBILE 

(Kk(7Sk ft HOME - MADISONS 

t-a Page ID : HOME - MADISONS 

14 5 


SAW912 MOBILE 

IQU ?1 n order summary - madisons 
^ ^ LJ Page ID : ORDER SUMMARY - MADISONS 

4 

3 

3 



SAW912 MOBILE 

FI SHOPPING CART - MADISONS 
1 — 1 Page ID . SHOPPING CART - MADISONS 

4 

3 

3 



SAW912 MOBILE 

(Ql a m PRODUCT: RED LEATHER ROLL ARM CHAIS 
LJ Page ID . PRODUCT: RED LEATHER ROLL A 

4 

3 

3 



SAW912 MOBILE 

folia ESI ORDER CONFIRMATION - MADISONS 
Cilivgl LJ Page ID . ORDER CONFIRMATION - MADIS< 

3 

3 

1 



SAW912 MOBILE 

fol a FI PAYMENT - MADISONS 

LJ Page ID . PAYMENT - MADISONS 

3 

3 

3 



SAW912 MOBILE 

BILLING ADDRESS - MADISONS 
Cilivgl LJ p age ID . BILLING ADDRESS - MADISONS 

2 

3 

3 



vrinn dt, i «nnncpt'cc', MAn.c'rti.r 






Figure 5-66 Detailed report of SAW912 Mobile category 8 


The report contains the columns of the category name, the page name, page 

view counts, entry page view counts, departure page view counts, sessions. 

Detailed information about these report columns are listed below: 

► Category name displays the name of the category. 

► Page name displays the name of the page. 

► Page view displays the counts of one page. 

► Entry page view displays the counts of the page that is taken as the entry 
point of a user session. 

► Departure page view displays the counts of the page which is taken as the 
exit point of a user session. 

► Sessions displays the session counts of the page. 

For example, the HOME MADISONS page has been viewed 1 4 times. Among 
these 14 page views, it was viewed five times as the entry point of a session 
and four times as the departure of a session. In addition, the page was 
accessed by five different sessions. One user session placed an order and 
accessed the order confirmation page, which is displayed by the ORDER 
CONFIRMATION page. 


8 Screen capture courtesy of Coremetrics, Inc. 
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16. Coremetrics also supplies top ranking information. Select Content 

Analysis 0 Top Visited Pages to display the top visited pages, as shown in 
Figure 5-67. 


Page 

Unique 

Average 

Views Page 

@ @ □ HOME - MADISONS 

2 

14 0:00:20 

(S) © □ PRODUCT: RED LEATHER ROLL ARM CHAISE 


4 0:00:50 

© @ □ SHOPPING CART - MADISONS 

1 

4 0:00:54 

@ □ ORDER SUMMARY - MADISONS 

1 

4 0:00:23 

g) © □ ORDER CONFIRMATION - MADISONS 

1 

3 0:00:15 

(3) © □ PAYMENT - MADISONS 

1 

3 0:00:30 

(31© □ HOME - MADISONS MOBILE 

1 

2 0:00:51 

(3) © □ MADISONS MOBILE - TABLE LAMPS - CATEGORY 

1 

2 0:00:12 

©©□ BILLING ADDRESS - MADISONS 

T” 

2 0:00:38 

© © □ YOUR BILLING ADDRESSES - MADISONS 

i 

2 0:00:08 

©@ □ PRODUCT: WHITE FABRIC LOVESEAT 

T” 

1 0:00:05 

© © □ MADISONS MOBILE - FURNITURE - CATEGORY 

i 

1 0:00:37 

IS) ® EFl MAnisriN*; mcirti f - pb cha i tnfm tarlf i amp 




Figure 5-67 Top visited pages report 9 


The top visited pages report shows the top 1 ,000 pages that were viewed at least 
once in the time period. The report contains columns of page, unique visitors, 
page views, and average time on page. 

For more Coremetrics report types, refer to: 
http : //www . coremetri cs . com/ 

You can add other tags to the Madisons Mobile Starter Store to perform more 
analytics, such as the merchandising and business-to-business contract 
analytics. For more information, refer to IBM WebSphere Commerce Version 7 
Information Center: 

http : //pub! ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp 


9 Screen capture courtesy of Coremetrics, Inc. 
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6 


Example client 
cross-channel solution 


This chapter shows how to apply IBM WebSphere Commerce features to a 
cross-channel solution. The Easy Hogar y Construccion company that we 
describe in this chapter scales from a service-oriented architecture (SOA) store 
to a cross-channel business model. This chapter discusses targeted marketing 
and promotion for Web and mobile channel users as well as how to use this 
information from an analytical perspective. 


© Copyright IBM Corp. 2010. All rights reserved. 
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6.1 Sample client solution 


Note: The Easy Hogar y Construccion company is a real company, not a 
fictional company. 


Easy Hogary Construccion is a home improvement retail store in South 
America. This company is owned by one of the biggest retailers in Latin America 
and has a variety of retail formats such as grocery stores, department stores, 
specialty stores, travel agencies, malls, and recreation centers among others. 
Easy Hogary Construccion products include appliances, building materials, tools 
and hardware, paint, storage, outdoors, kitchen, flooring, decor, doors and 
windows, electrical, lighting and fans, and so forth. 

A number of years ago, Easy Hogar y Construccion decided to open a new store 
in Colombia. The company’s board realized the benefits of trying a new retail 
model with this store. The new store provided an opportunity for Easy Hogar y 
Construccion to move from an SOA store to a cross-channel solution. This new 
solution created a shared business vision and a sense of ownership between the 
company and the business. 
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Figure 6-1 shows a one of the Easy Hogar y Construccion company 
brick-and-mortar stores. 



Figure 6- 1 Easy Hogar y Construccion 
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6.1 .1 Challenges for today’s global retailer 


As a global retailer, Easy Hogar y Construccion must take advantage of common 
processes in order to maintain a regional presence while also adapting to local 
demands and expectations. 

Over the last 6 years, the retail industry has become more operationally focused 
and resources have gone into supply chain efficiency, cost reduction, and 
operational effectiveness. Focusing resources on these tasks was driven 
primarily by pressure from competitors; however, Easy Hogar y Construccion 
understands that today’s shoppers want convenience and product availability. 
The company must be ready for this market’s opportunity. 

Today’s retailers also face increasing pressures due to the weak economic 
environment, which increases costs and competition from new sources. 


Note: Being a successful company today is not just about saving time and 
money. Companies must realize that the shopping experience begins and 
ends at the shopper’s front door, not the front door of a brick-and-mortar store. 


The major concern for Easy Hogar y Construccion was that touchpoints for 
shoppers were separate silos of execution, both organizationally and 
technologically; however, the shopper sees retail brand identity as a single entity. 


6.1.2 Business requirements 

The new cross-channel solution for Easy Hogar y Construccion includes the 
following main business requirements: 

► Design a retail model that lets the company grow and operate efficiently. 

► Identify high service hours that occur because of shopper complaints, and 
invest in solutions to address the issues to achieve the following goals: 

- High customer satisfaction 

- Improved profit margin 

- Increased revenue potential 

- Additional customer reach 

- Low cost transactions 

- Personalized customer service 

- Optimal buyer impulse use (precision marketing) 

- Access to real-time information 

- Increased transaction size (average ticketing) 

- Enhanced loyalty 

- New channel support with common services 
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- An intuitive, inviting, and fast shopping experience 

- Real time to market 

- Consumer activity tracking that provides a single view of the shopper 

6.1.3 IT requirements 

In keeping with the business goals outlined in 6.1.2, “Business requirements” on 
page 424, the IT department of Easy Hogar y Construccion suggests the 
following technical requirements for this solution: 

► Decouple business systems to allow reuse of business logic in other 
environments. 

► Reduce IT development costs by adhering to technical standards for the retail 
industry. 

► Lower maintenance costs by integrating disparate applications, databases, 
and operating systems. 

► Take advantage of the network and Internet technology to support shopper 
demand and to meet shopper expectations. 


6.1.4 Analyzing the requirements and managing expectations 

To determine how to proceed to meet the requirements of a successful 
cross-channel solution, Easy Hogar y Construccion defined business scenarios 
with relevant stakeholders. Easy Hogar y Construccion began by asking 
questions such as “How much of our existing technology assets are viable in the 
new cross-channel efforts?” Using risk analysis, the company determined which 
requirements had a high negative impact to the business and needed to be 
delayed, and which requirements failed a cost benefit analysis (CBA) and 
needed to be rejected. After the risk analysis, the company then communicated 
the requirements throughout the company to ensure that expectations were met 
successfully. 

Easy Hogar y Construccion began with an enterprise architecture approach 
using retail industry standards that let the company identify the gaps for building 
a roadmap based on actual IT projects. The company defined business and 
technology standards capabilities that were required to realize its goals. The first 
steps included: 

► Assessing present operations. 

► Defining future capabilities to enable a new efficient retail model that includes 
a cross channel strategy using best practices. 
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► Assessing the ability to execute a strategy that includes costs and risk levels. 

► Defining and prioritizing gaps. 

Then, Easy Hogar y Construccion made a high-level strategic roadmap and 
business case where they defined key projects, costs, and time lines that are 
required to achieve the following objectives: 

► Develop a multi-stage roadmap for maximum value realization 

► Identify opportunities for quick wins 

► Pinpoint milestones to gauge progress 

► Establish new business metrics and expected return on investment 

The Easy Hogar y Construccion multi-stage roadmap provides the following main 
tasks: 

► Aligning the business and IT processes using SOA 

► Building a cross-channel strategy 

We describe these tasks in the sections that follow. 

6.1.5 Phase 1: Aligning the business and IT processes using SOA 

Easy Hogar y Construccion uses IBM Retail Integration Framework and the 
Association for Retail Technology Standards (ARTS) to build the basic framework 
to use SOA as the main vehicle for integration within the company’s IT 
infrastructure. Using a bottom-up approach and service-oriented modelling and 
architecture (SOMA) methodology, Easy Hogar y Construccion identified 
services for applications and main processes to build a main catalog that enables 
business applications to integrate according to the company’s business strategy. 

For better interoperability, the company decided that all applications must use the 
ARTS XML standard interface. Also, Easy Hogar y Construccion decided to use 
the ARTS SOA blueprint that defines how Web services standards are joined 
with the ARTS message and data standards model to build a retail SOA. This 
model defines major retail enterprise business levels such as 

► Home office 

► Distribution center 

► Retail store business level 

Figure 6-2 describes the main components for an SOA blueprint in the retail 
industry. This model offers a good reference to develop an enterprise 
architecture for retail companies that uses a common vocabulary between the 
business and IT process. It provides business scenarios, Web services samples, 
data models, and XML schemas that the company can use following the IBM 
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Retail Integration Framework to build a solid foundation for the business and IT 
environment. 



Figure 6-2 ARTS SOA blueprint and best practices overview 


For Easy Hogar y Construccion, using ARTS with the IBM Retail Integration 
Framework provides the following benefits: 

► A common language for all platforms. 

► All applications are decoupled, and Easy Hogar y Construccion can model 
business processes while interconnecting actual applications. 
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► All devices are ready to use a service from a business process or application, 
so shoppers can obtain accurate information from Easy Hogar y 
Construccion. 

► Point-of-Sale (POS) systems, PDAs, and kiosks are 100% SOA enabled, so 
they use services to get shopper information, promotions, tax calculations, 
orders, and so forth from one single service repository where governance 
policies are applied. 

Figure 6-3 shows how this SOA approach can be applied. 
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Figure 6-3 SOA logical model 
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SOA store model logical components 

The architecture for an SOA store model includes the following components: 

► In-store component 

This component is usually called in-store processor. It is a server in the store. 
This server has several devices connected to it, including POS controllers and 
terminals, kiosks, self-checkout systems, and other devices. 

► SOA-enabled POS 

POS applications use store integrator capabilities to extend or bypass the 
logic of existing POS applications using a central SOA server to communicate 
with the Web and a variety of other applications and systems to support 
mobile shoppers, Web-based sales transactions, and a variety of devices. 

► Enterprise component 

This component is a central management point for the in-store processors. 
Software installations and monitoring data is managed from the Enterprise 
server. 

Figure 6-4 shows a high-level retail environment sample configuration. 
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This environment consists of the following components: 

► Enterprise service bus 

A component to manage integration and connectivity logic to de couple 
applications. 

► Service registry 

A component to manage SOA governance. 

SOA store model software components 

The SOA store model solution include the following software components: 

► IBM WebSphere Remote Server 

This solution is a collection of IBM middleware products that is intended to be 
a software stack for running Web applications within a store called WebSphere 
Remote Server Entry Edition and at main datacenter called WebSphere 
Remote Server Enterprise Edition. It includes the following components: 

- IBM WebSphere Application Server 

- IBM WebSphere MQ 

- IBM DB2 

- Tivoli Configuration Manager 

- Tivoli Enterprise Console® (TEC) 

- Tivoli Monitoring 

- Tivoli Monitoring for Databases 

- IBM Tivoli Composite Application Manager for WebSphere 

- Tivoli OMEGAMON® XE for Messaging 

► IBM WebSphere Systems Management Accelerators 

These accelerators are a collection of tools that provide multiple functions in 
setting up a store environment. It provides the following features: 

- Provides easy installation of WebSphere Remote Server across numerous 
machines. 

- Extends the monitoring capability of IBM Remote Management Agent to 
collect information from events at store. 

- Provides integration between WebSphere Remote Server components 
running at the ISP and Tivoli products running at the enterprise central 
site. 

► IBM ACE POS 

ACE is the next generation IBM POS that takes advantage of traditional IBM 
POS solutions with new integration components that are coded in C++ and 
Java. 
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► Store Integrator Application Extension Facility (AEF) 

This solution lets the POS terminal sales program run under the AEF client 
session server software in a POS terminal, on an in-store processor, or in any 
device as part of a Web-based application. It includes the following main 
components: 

- POS Data Provider, which monitors events and only provides information 

- POS Automation Provider, which allows an external application to use 
POS functions and is driven by an API 

- POS Service Provider Proxy, which allows an external application to add 
or replace POS functions and is used to replace or alter POS behavior 

- POS Device Access, which provides control of the POS I/O 

Figure 6-5 shows the ACE development environment, where Easy Hogar y 
Construccion developers can trace transaction flow and analyze data storage. 
Using AEF, it is possible to add new dialog boxes or to invoke new services to 
enhance POS functionality. 
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► Store Integrator GUI 

Using this feature with AEF provides touch-screen support for operator and 
customer graphical interfaces. The data transferred between the existing 
application and Store Integrator GUI is in XML format, rather than being 
unique to the particular POS application being used. Store Integrator GUI 
runs on top of AEF, which in turn runs on top of the existing terminal sales 
application. The flexibility of this architecture enables AEF and Store 
Integrator GUI to run without requiring modifications to the terminal sales 
application. 

Figure 6-6 shows store integrator flows to manage a sales transaction. 



Figure 6-6 POS, JIOP, AEF, and store integrator GUI in a real terminal 


► IBM WebSphere Enterprise Service Bus 

Using the IBM SOA logical model, Easy Hogar y Construccion can define the 
following boundaries for the project scope: 

- Business logic (business services) are outside WebSphere Enterprise 
Service Bus. WebSphere Enterprise Service Bus contains only integration 
logic or connectivity logic. 

- Security and Management are loosely coupled to WebSphere Enterprise 
Service Bus. The policy decision point is outside WebSphere Enterprise 
Service Bus, and WebSphere Enterprise Service Bus is policy 
enforcement point. 
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- Service Registry is tightly coupled to WebSphere Enterprise Service Bus 
because the registry is a policy decision point for WebSphere Enterprise 
Service Bus and because WebSphere Enterprise Service Bus is a policy 
enforcement point for the registry. 

Figure 6-7 shows the SOA logic model interaction with WebSphere Enterprise 
Service Bus and registry components. 



Figure 6-7 SOA logic model 

► IBM WebSphere Service Registry and Repository 

WebSphere Service Registry and Repository is the master metadata 
repository for service interaction that Provides Service Visibility and 
Governance for SOA services and policies. 

Interactions between components 

WebSphere Enterprise Service Bus and WebSphere Service Registry and 
Repository provide Easy Hogar y Construccion with an infrastructure to support 
the SOA catalog as well as business and IT events. 

When POS needs SOA interaction, Easy Hogar y Construccion modifies the 
store integrator GUI to have access to transaction information. Thus, the 
company can retrieve any Web services through the ESB according to 
WebSphere Service Registry and Repository policies. Used with AEF, Easy 
Hogar y Construccion can modify the GUI to add new multimedia or Web page 
content. 
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Figure 6-8 shows a sample for the operator GUI. Each button palette can invoke 
a local function or a remote service to complete transactions. 



Figure 6-8 Store integrator Ul operator window 

Each Easy Hogar y Construccion application manages a set of services that can 
be composed to complete a business transaction. 
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Figure 6-9 describes the ESB mediation flows. 



Figure 6-9 Easy Hogary Construccion service usage 


The Easy Hogar y Construccion architecture includes the following ESB main 
functions: 

► Provide interaction patterns for communication protocols: 

- Supply basic connectivity to requesters and providers 

- Manage impact QoS (for example, reliable delivery and transactions) 

- Supply inherent interaction patterns (for example, request or reply, 
one-way, and pub or sub) 

- Provide support for the following standards: 

• Hypertext Transfer Protocol (HTTP), including SOAP/HTTP, and 
XML/HTTP 

• MQ (SOAP/JMS/MQ, XML/MQ, and text/MQ) 

• Adapters (existing, EIS) 

• WS-I, WS-Security 
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► Provide support for meta models and message models: 

- Describe messages that are exchanged with requesters and providers 

- Manage customized XML meta models (IXRetail) 

- Support multiple message content models 

- Support industry-standard models as well as enterprise specific models 
such as ARTS 

► Provide support for mediation flows and manage service visualization^ 

- Identity through routing basic, composed mediation patterns 

- Interaction (protocol or and pattern) through conversion 

- Interface through transformation 

- Aspect-oriented connectivity as security management, logging, and 
auditing 

Figure 6-10 shows ESB Easy Hogar y Construccion extended scope that 
supports ARTS by the Meta models within the ESB. 



Figure 6-10 ESB patterns 

Main challenges 

The main challenges for the SOA store include: 

► Understanding cross-industry best practices and business context for retail. 

► Removing barriers to integration with back-end systems and sales channels. 

► Enabling real-time event notification to be able to react to business issues. 

6.1.6 Phase 2: Building a cross-channel strategy 

Retail as a distributed business depends on the flow of information to and from 
the remainder of the enterprise as well as various external organizations. Easy 
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Hogar y Construccion needs a single platform to connect its business to its 
shoppers and to the business partners in its supply chain. 

IBM WebSphere Commerce is the key component to managing a cross channel 
strategy using composite applications that integrate actual services catalog using 
the SOA logical model that we described in Figure 6-3 on page 428. WebSphere 
Commerce provides the service components shown in this figure, such as 
promotions, order, catalog, and so forth. 

Cross-channel logical components 

Figure 6-1 1 shows the logical areas of a cross channel architecture. 



Channels 

• Point of Sale 

• Kiosk 

• Mobile Phone 

• PDA 

• Web Store 



Core Business 
Components 


• Core Business 
Services 

• ESB 

• Master Data 



Cross 

Channel 

Management 

• Targeted 
Marketing 

• Promotions 

• Analytics 



Figure 6-11 Logical model for a cross channel architecture 


This cross-channel architecture includes the following components: 

► Channels define, from a shopper’s point of view, how a shopper can reach 
Easy Hogar y Construccion company and how the shopper sees the entire 
company as a unique brand, regardless of channels and external providers in 
the supply chain. Channels are about the shopping experience. 

► Core Business Components describe, from the IT point of view, the main SOA 
infrastructure. This component is about governance, service catalog, and 
mediation. 

► Cross-channel Management defines from a business point of view how Easy 
Hogar y Construccion can provide service rules that govern customer 
experience. Easy Hogar y Construccion knows that a cross channel strategy 
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must provide the necessary incentive to stimulate purchase behavior, to build 
the necessary awareness for the offer, and to develop optimum value 
perception. So, this logical level is business-oriented to produce and manage 
cross channel iniatives that avoid barriers to promotion participation. 

Cross-channel software components 

The main components of the cross-channel solution are: 

► IBM WebSphere Commerce 

► The SOA store model 

These components are combined to create a unified shopping experience 
throughout all channels. 

Main challenges 

The cross channel strategy includes the following main challenges: 

► Building a single view of the shopper from multiple channels, such as a Web 
site, kiosk, mobile device, POS, and call center. 

► Providing the shopper with a single view of Easy Hogar y Construccion 
throughout multiple channels. 

► Empowering the customer. 

► Linking customer interactions with ongoing promotions. 

► Ensuring that product information is relevant and accurate. 

► Bringing differentiated services and programs to market more rapidly and 
efficiently. 

► Gaining insight into the shopper’s needs, wants, and value drivers. 

6.1.7 Sample scenarios using the architecture 

Easy Hogar y Construccion is using main basic business services with the ARTS 
SOA blueprint model. Each transaction, regardless of the channel, is recorded 
within the ARTS data model, allowing any other channel that might need this 
information to retrieve the transaction. 

The ARTS data model contains special fields for logging transaction metadata. 
For example, this metadata can be used to trace the life cycle of an order that 
was purchased on the Web and subsequently returned in store. Using service 
components, any device is able to retrieve order payment information at store. 
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Process return case scenario 

In this section, we expand on the purchase made on the Web. Now the shopper 
wants to return the product at a physical location. To complete this scenario, the 
following steps occur: 

1 . The shopper provides proof of purchase to the operator. If the proof of 
purchase is not available, the operator can retrieve purchase history using the 
shopper’s identification and information. 

2. The POS system retrieves the order information from the WebSphere 
Commerce order service component through WebSphere Enterprise Service 
Bus. WebSphere Commerce returns the order information to POS system. 

3. The order is displayed at the POS system using the store integrator GUI, and 
the operator chooses which item the shopper is returning. 

4. The operator must choose a return reason. If the reason indicates a fault of 
Easy Hogar y Construccion, such as a quality issue or damage to the 
merchandise, then a trigger is activated to present the shopper with an 
apology and to provide the shopper with a coupon for the next purchase. 

5. The POS system processes the refund. 

6. The transaction is saved on the main ARTS repository, which triggers an 
inventory service invocation to adjust the inventory. 

Finish a Web or mobile transaction case scenario 

This section describes a buy online, pick up in store scenario (referred to as 
BOPIS in this book). The shopper submitted the order through the Web and now 
wants to pick up the purchase from the store. 


Note: IBM ACE POS can be running inside an IBM POS system, or it can be 
running in a special device such as a PDA, kiosk, or PC using AEF, depending 
on the store strategy. 


To finish a Web or mobile transaction: 

1 . The shopper provides an identification to retrieve order information. 

2. The POS system sends information using the ARTS XML schema through 
WebSphere Enterprise Service Bus to WebSphere Commerce. This message 
can be enhanced by the ESB mediation module (for example if additional data 
from other sources is needed). 
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3. The operator can add more items to the order if necessary. Using the touch 
screen monitor, Easy Hogar y Construccion can show advertisements that 
are tailored to this particular shopper. 

4. The transaction is saved on the main ARTS repository, which triggers an 
inventory service invocation to adjust the inventory. 

Figure 6-12 shows a high-level overview of the architecture components. 



Figure 6-12 Solution high-level overview 
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Future enhancements 

Working with this retail model, Easy Hogar y Construccion is ready to move to 
the next step: 

► Add a business process engine such as IBM WebSphere Process Server to 
provide more complex cross channel and cross brand visibility into inventory, 
order status, and fulfillment activities. 

► Build a business-to-business marketplace with value added networks. 

6.1.8 Conclusion 

The story of Easy Hogar y Construccion was successful because the company 
went from a small implementation to a large scale enterprise. Depending on a 
company’s cross channel operational maturity and desired future state, a given 
organization must look for daily projects that lets them align their business and IT. 


6.2 Targeted marketing and promotion for Web and 
mobile channel users 

Easy Hogar y Construccion has multiple customer touchpoints that allow for 
convenient access to company offerings. The company is committed to providing 
service for its shoppers and a unique shopping experience. The marketing team 
is seeking new ideas to exploit the full potential of the current IT infrastructure. 

6.2.1 Case scenario goals 

Easy Hogar y Construccion needs to provide a consistent cross-channel 
experience where shoppers can initiate an order by mobile device, kiosk, Web, or 
POS and then modify, cancel, or submit the order using another channel when 
needed. 

Easy Hogar y Construccion has developed the following initiatives: 

► Attract shoppers to the store where they find a unique shopping experience 
as well as special in-store discounts. 

► Offer store-only coupons and incentives online. 

► Facilitate in-store pickup of online orders. 

► Include easy views of available in-store inventory. 

► Allow shoppers to find stores close to home. 
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Easy Hogar y Construccion offers the following devices at the store: 

► Web-enabled and SOA enabled POS systems that accept online orders and 
reservations 

► Wireless kiosks where shoppers can place orders upon arrival at the store 

► PDA to provide shoppers with a different purchase experience 

► Wireless access for customer mobile devices 


6.2.2 Easy Hogar y Construccion registration sample 

Using the cross channel software components that we described in 6.1 , “Sample 
client solution” on page 422, Easy Hogary Construccion implements a marketing 
strategy for customer registration. Table 6-1 shows an overview of the business 
requirements for this sample. 


Table 6-1 Cross-channel registration sample 


Business Requirements 

Strategy 

Easy Hogar y Construccion needs to 
provide a unique cross channel customer 
registration procedure that lets the 
company work customer segmentation, 
targeted marketing using Web page, 
kiosk, or mobile device. 

Easy Hogar y Construccion needs to 
manage alliances with other companies to 
let customers build home improvement 
tasks with the company. 

Easy Hogar y Construccion needs to track 
daily registrations and needs to analyze 
data to generate new sales. 

Registration provides customers a free insurance policy as a 
gift, free courses, and promotions that collect a customer’s 
occupation. 

Each third-party alliance manages different targeted 
marketing promotions, and their mobile phones are the first 
tool to do marketing promotions. 


To fulfill the business requirements listed in Table 6-1 on page 442, Easy Hogary 
Construccion needs to implement the following steps: 

1 . Customize the Madisons Mobile Starter Store registration page. 

2. Customize the Madisons Starter Store Web page, and include tags for 
analytics and e-Marketing Spots for promotions. 

3. Load the third-party customer database. 

4. Modify the store GUI to add a link to the Madisons Starter Store Web. 

5. Modify the store GUI to run advertisements for Easy Hogar y Construccion 
registration. 
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6. Modify the kiosk GUI to include access to the Madisons Starter Store Web. 

7. Modify the kiosk GUI to include advertisements for Easy Hogar y 
Construccion registration. 

Figure 6-13 shows a customer using kiosk solution to register at Easy Hogar y 
Construccion. The kiosk shows a registration option that is linked with 
WebSphere Commerce to apply e-Marketing Spots to qualifying customers. 



Figure 6- 13 Easy Hogar y ConstruccionCustomer registration kiosk 
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6.2.3 Easy Hogar y Construccion “do it yourself” project sample 

Using the cross channel software components that we described in 6.1 , “Sample 
client solution” on page 422, Easy Hogary Construccion implements a marketing 
strategy for shopper “do it yourself projects” (or DIY projects). Table 6-2 shows 
an overview of the business requirements for this sample. 


Table 6-2 Cross-channel customer DYI project sample 


Business Requirements 

Strategy 

Easy Hogar y Construccion needs to 
provide shoppers a unique and convenient 
shopping experience at the store. 

Shoppers can choose products for the project using the Easy 
Hogar y Construccion PDA. They can place an order and can 
choose a sales assistant to help if needed, while walking in 
the store. 

Easy Hogar y Construccion provides 
convenient access to project templates to 
help customers choose the right products 
for their need. 

Easy Hogar y Construccion configures project templates at 
the Madisons Mobile Starter Store to let the shopper use as 
initial proposals. For example, Easy Hogar y Construccion 
can provide templates for kitchen improvement. 

Easy Hogar y Construccion offers in-store 
wireless kiosks and PDA for shoppers. 

Easy Hogar y Construccion provides Wireless Order Entry. 
Shoppers can manage convenient access with a digital 
personal assistant or wireless access using a mobile device. 
These devices allow shoppers to order from a customized 
shopping list. 

Easy Hogar y Construccion needs to track 
project templates history and 
effectiveness. 

Suggest products based on previous selections to increase 
sales. 

Easy Hogar y Construccion configures Targeted Marketing 
and promotions for Web and mobile channel for these 
shoppers. 
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To fulfill the business requirements listed in Table 6-2 on page 444, the Easy 
Hogar y Construccion company needs to complete the following steps: 

1 . Customize the Madisons Mobile Starter Store order process. 

Figure 6-14 shows a shopper using a mobile device to retrieve a special order 
that was made at home. The shopper retrieves the order to add new products 
and to verify product details. 



Figure 6-14 In store Madisons Mobile Starter Store access 


2. Customize the Madisons Starter Store Web page to include tags for analytics. 

3. Configure targeted marketing and promotions for special projects. 

4. Modify the ESB mediation to manage order management, which manages 
basic operations such as retrieve, modify, and cancel an order in WebSphere 
Commerce. 

5. Modify the store GUI to add Web service call to order management. 

6. Modify the store GUI to run advertisements for order management on Easy 
Hogar y Construccion channels. 

7. Modify the kiosk GUI to include Web service call to order management. 

8. Modify the kiosk GUI to include advertisements for Easy Hogar y 
Construccion order management. 
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Figure 6-15 shows a shopper’s interaction with a sales assistant who manages a 
DYI project using a PDA device on a cross channel solution. 



Figure 6-15 PDA wireless customer access 


Figure 6-16 shows a POS solution that is integrated into a cross channel 
solution. In the picture, a shopper watches advertisements at a touch screen, flat 
panel while an operator uses a touch screen monitor to manage transaction 
operations. As explained previously, this solution retrieves order information from 
WebSphere Commerce. 

The POS function provides a unique shopping experience and provides the 
company with feedback regarding consumer behavior across all channels. POS 
systems are always retrieving online information about promotions and product 
details. 
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Figure 6-16 Store GUI modification to retrieve order information 
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6.2.4 Easy Hogar y Construccion family connections strategy sample 


Using the cross channel software components that we described in 6.1 , “Sample 
client solution” on page 422, Easy Hogar y Construccion manages a marketing 
strategy for family connections. Table 6-3 lists the business requirements for this 
sample. 


Table 6-3 Cross-channel family connections sample 


Business Requirements 

Strategy 

FAMILY CONNECTIONS 

Easy Hogar y Construccion needs to offer 
a different kind of service keeping 
customers connected with their family and 
friends during important life events. 

Easy Hogar y Construccion recognizes 
today’s potential value for customer 
retention or customer acquisition such as 
young couples that are being invited to 
build projects with Easy Hogar y 
Construccion. 

Easy Hogar y Construccion offers flower gifts to shoppers, 
where the shopper can search, buy, and pay using the same 
channels. After shoppers determine the template for the 
flower gift, the system must include an alert with the order, as 
part of a targeted marketing strategy. 

Gift Registry 

Social Commerce 

SOCIAL COMMERCE 

Easy Hogar y Construccion needs to offer 
access to a Web community where people 
can find professional services for the 
products that they buy. Shoppers can 
share product and service reviews, 
collaborating in a new social environment. 

Use online customer rating and feedback 
to improve shopper product selection and 
comparison shopping. 

As part of the WebSphere Commerce evolution, Easy Hogar 
y Construccion implements social commerce features. 


To fulfill the business requirements listed in Table 6-3 on page 448, the Easy 
Hogar y Construccion company needs to implement the following steps: 

1 . Install the gift registry installation. 

2. Install the sales center. 

3. Install the social commerce feature. 

4. Customize the Madisons Mobile Starter Store Registration page. 

5. Customize the Madisons Starter Store Web page to include tags for analytics 
and tags marketing spots for promotions. 
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6. Modify the ESB mediation to manage order management. 

7. Modify the store GUI to add Web service call to order management. 

8. Modify the store GUI to run advertisements for order management on Easy 
Hogar y Construccion channels. 

9. Modify the kiosk GUI to include Web service call to order management. 

10. Modify the kiosk GUI to include advertisements for Easy Hogar y 
Construccion order management. 

Figure 6-17 shows a shopper using the flower gift center to send flowers to family 
and friends on special dates. Easy Hogar y Construccion uses this service to 
reward shoppers based on segmentation and purchase history. This kiosk 
strategy is also used with gift registry to support an entire loyalty program for 
shoppers. 



Figure 6-17 Kiosk using Family Connections Strategy 
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6.3 Cross-channel precision marketing 

To maximize conversion rates in a cross channel environment, Easy Hogar y 
Construccion wants to track and analyze cross channel customer behavior to 
gain insights and then apply those insights to its sales and marketing initiatives. 

6.3.1 Marketing strategy 

Easy Hogar y Construccion develops a cross-channel plan that includes the 
following marketing and operational goals: 

► Create product offers and services for channels. 

► Coordinate brand look. 

► Execute unified marketing plans between channels. 

► Improve new programs for new channels such as mobile strategy. 

► Create single brand identity across channels. 

► Continuously improve operational excellence across channels. 

► Determine new customers segments that might be worthwhile to target in the 
Web site, kiosk, or any other channel. 


6.3.2 Indicators 

Easy Hogar y Construccion needs to track orders by channel to develop new 
strategies. Table 6-4 shows some key indicators to measure. 


Table 6-4 Cross-channel main indicators 


Operations 

Indicators 

Purchase 

► Customer segmentation by channel 

► Average conversion rate 

► Average order value 

► Average per visit / channel value 

► Average ROI 

► Percentage revenue from new visitors 

► New customer on first interaction index 

► Shopping Discounts by Channel 

Order Input 

► Percentage visits by channel 

► Percentage goal conversion by channel 

► Percentage visit by channel 

► Average ROI by channel 

► Cancelled Orders by Type, Reason 
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Operations 

Indicators 

Marketing 

► Customer Satisfaction by Channel 

► Number of advertisements clicked 

► Percentage brand engagement 

► Goal conversion index by channel 

► Percentage of new versus returning visitors 

► Percentage of new versus returning customers 


6.3.3 Using WebSphere Commerce features 

Easy Hogar y Construccion uses the marketing activities described in this 

section for planned customer interactions. 

Campaigns 

Using WebSphere Commerce campaigns for customers, Easy Hogar y 

Construccion manages Web and e-mail activities: 

► Campaign using customer occupation 

Every 2 weeks there is a special event using shopper occupations (for 
example, painters, architects, or designers). This feature lets the company 
collect all professionals contact information to offer special prices for affiliated 
occupations and projects. If the shoppers bring their customers to Easy 
Hogar y Construccion, the shoppers become strategic partners of a new 
social community. 

► Campaign for third-party alliances 

This campaign uses third-party databases from alliances that let the company 
offer special targeted promotions. For public services companies, Easy Hogar 
y Construccion offers special events each week to promote “green home 
projects” that offer special devices that consume less energy. In this example, 
e-mail marketing allows Easy Hogar y Construccion to reach shoppers who 
have not yet visited a store. Finally, e-mail and Short Message Service (SMS) 
marketing lets the company keep regular shoppers up-to-date regarding 
upcoming events and products. 
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Web activities 

Web activities let Easy Hogar y Construccion control predefined e-Marketing 
Spots on the store pages. Table 6-5 describes these Web activities. 


Table 6-5 Web activities samples 


Pages 

Goal 

StoreHomePage e-Marketing Spot 

Display ads about how to save money using less energy 
consumption devices 

Shopping Cart e-Marketing Spot 

Display based on purchase conditions how to get free 
shipping 

Product Display Page e-Marketing Spot 

Upsell merchandising association for the current catalog. 


Dialog activities 

Dialog activities let Easy Hogar y Construccion to look for methods to automate 
marketing actions based on specific customer behaviors over time. Using trigger, 
target, and action components, Easy Hogar y Construccion can generate the 
following new dialog activities: 

► When a shopper places an order, check the past purchase history credit. If 
payment history is successful for the last 6 months, move the shopper to the 
pre-approval building budget customer segment. 

► When shopper information comes from a third-party source, for example 
public service energy company, then offer the shopper green products to save 
energy at home for 2 months. 

► When the shopper’s age is between 20 and 30 and the shopper is married, 
move the shopper to the young new couples customer segment and send the 
shopper SMS about saving money for home projects. If the shopper has pets, 
then add the shopper to a special pet customer segment as well. 
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6.4 Summary 

A cross channel strategy works with the complete picture to provide an 
understanding of how to create a new shopping experience that aligns business 
and IT. The key is to understand the process that really work and how to measure 
your success. 

The successful implementation for Easy Hogar y Construccion had the main 
keys of IT and human factors. IT was supported by an excellent team of 
individuals that were hired to develop a new vision and to make a self-consulting 
process that was delivered later by IBM and its business partners. This team was 
able to develop a methodology that provide that the human factor is a critical 
asset when building a company vision for the future. 


Chapter 6. Example client cross-channel solution 


453 



454 Building Multichannel Applications with WebSphere Commerce 



A 


Samples of WebSphere 
Commerce SOA Service 
Request and Response 


This appendix includes samples of WebSphere Commerce SOA Service 
Request and Response used by the distributed order management (referred to 
as DOM throughout this book) integration solution. 
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A.1 ProcessInventoryRequirement with 
action code Reservelnventory request 

Example A-1 shows the ProcessInventoryRequirement request with the action 
code Reservelnventory request. 

Example A- 1 ProcessInventoryRequirement request with action code Reservelnventory 

<_inv: ProcessInventoryRequirement 

xml ns :xsi = "http: //www. w3.org/2001/XMLSchema- instance" 

xml ns :_i nv="http : //www. i bm. com/xml ns/prod/commerce/9/i nventory" 

xml ns :_ord=" http: //www. ibm.com/xml ns/prod/commerce/9/order" 

xml ns :_wcf=" http: //www. ibm.com/xml ns/prod/commerce/9/foundation" 

xml ns :oa=" http: //www. openappl icati ons.org/oagi s/9" releaseID="9.0" 

versionID="6.0.0.4"> 

<oa:Appl icati onArea xsi :type="_wcf : Appl icati onAreaType"> 

<oa : Creat i onDateTime>2009-08- 1 1T16 : 09 : 28.2 18Z</oa : Creat i onDateT i me> 
<oa:B0DID>58111cf 0-869 l-llde-845f-84214a818784</oa:B0DID> 

<_wcf :BusinessContext/> 

</oa:ApplicationArea> 

<_inv:DataArea> 

<oa:Process> 

<oa:ActionCriteria> 

<oa:ActionExpression act ionCode=" Reservelnventory" 
expressionLanguage="_wcf :XPath">/InventoryRequirement[l]</oa:ActionExpr 
ession> 

</oa : Acti onCri teri a> 

</oa:Process> 

<_i nv : InventoryRequi rement shi pAsCompl ete="true"> 
<_ord:0rderldentifier> 

<_wcf : Uni quel D>12501</_wcf: Uni quel D> 

</_ord :0rderldenti f i er> 

<_ord : Storeldenti f i er> 

<_wcf : Uni quel D>10001</_wcf: Uni quel D> 

<_wcf: External Identifier 

<_wcf : Nameldenti f i er>Madi sons</_wcf : Nameldenti f i er> 

</_wcf: External Identifier 
</_ord : Storeldenti f i er 
<_ord : Buyerldenti f i er 
<_wcf : Uni quel D>2</_wcf: Uni quel D> 

<_wcf : Di sti ngui shedName>ui d=wangful ,o=defaul t 
organi zati on , o=root organi zati on</_wcf : Di sti ngui shedName> 

</_ord : Buyerldenti f i er 
<_ord:OrderAmount> 
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<_wcf :GrandTotal currency="USD">323.99000</_wcf :GrandTotal> 
<_wcf :Total ProductPrice 

currency="USD">449.99000</_wcf: Total Product Pri ce> 

<_wcf: Total Adjustment 

currency= "USD">- 126 . 00000</_wcf : Total Adj ustment> 

<_wcf :Adjustment> 

<_wcf :llsage>Discount</_wcf :llsage> 

<_wcf :Code>Furniture Category Di scount</_wcf :Code> 

<_wcf: Description 1 anguage="-l">Save 20% on 
Furniture !</_wcf : Descript ion> 

<_wcf: Amount currency="USD">-90.00000</_wcf :Amount> 

<_wcf : Di spl ay Level >0rderltem</_wcf : Di spl ay Level > 

</_wcf : Adjustment 
<_wcf :Adjustment> 

<_wcf :llsage>Discount</_wcf :llsage> 

<_wcf :Code>Save 10% on all orders today</_wcf :Code> 

<_wcf: Description 1 anguage="-l">Save 10% on all 
orders</_wcf :Description> 

<_wcf: Amount currency="USD">-36.00000</_wcf :Amount> 

<_wcf : Di spl ay Level >0rder</_wcf: Di spl ay Level > 

</_wcf : Adjustment 
<_wcf: Total Shi ppi ngCharge 
currency="USD">0.00000</_wcf :Total Shi ppi ngCharge> 

<_wcf: Total Sal esTax currency="USD">0.00000</_wcf : Total Sal esTax> 
<_wcf: Total Shi ppi ngTax 

currency="USD">0.00000</_wcf :Total Shi ppi ngTax> 

</_ord : OrderAmount> 

<_ord : OrderPayment I nf o/> 

<_ord:OrderStatus preparelndi cator="fal se"> 

<_ord : Status>P</_ord : Status> 

</_ord : OrderStatus> 

<_ord : LastUpdateDate>2009-08- 1 1T16 : 08 : 52 . 687Z</_ord : LastUpdateDate> 
<_ord:0rderltem> 

<_ord :0rderltemldenti f i er> 

<_wcf : Uni quel D>45001</_wcf: Uni quel D> 

</_ord : Order I temldenti f i er> 

<_ord : Catal ogEntry Identi f i er> 

<_wcf : Uni quel D>10002</_wcf: Uni quel D> 

<_wcf: External Identifier 
<_wcf :PartNumber>FUL0-0101</_wcf :PartNumber> 

</_wcf: External Identifier 
</_ord : Catal ogEntry Identi f i er 
<_ord : Quant i ty uom= "C62 ">1 . 0</_ord : Quant i ty> 

<_ord : Contract Identi f i er 


Appendix A. Samples of WebSphere Commerce SOA Service Request and Response 


457 



<_wcf : Uni quel D>10001</_wcf : Uni quel D> 

</_ord: Contract Identifier 

<_ord : Of f er I D>10002</_ord : Of f er I D> 

<_ord :OrderItemShi ppi nglnfo expedi te="fal se"> 

<_ord : Shi ppi ngAddress> 

<_wcf : Contact InfoIdentifier> 

<_wcf : Uni quel D>10076</_wcf: Uni quel D> 

<_wcf: External Identifier 
<_wcf :ContactInfoNickName>Calgary 
Mai l</_wcf :ContactInfoNickName> 

</_wcf: External Identifier 
</_wcf : Contact Infoldentifier 
<_wcf :ContactName> 

<_wcf : PersonT i tl e></_wcf : PersonT i t 1 e> 

<_wcf : LastName>Cal gary Mai 1 </_wcf : LastName> 

<_wc f : Fi r s t Name></_wc f : Fi r s t N ame> 

<_wcf : Mi ddl eName></_wcf :Mi ddl eName> 

</_wcf :ContactName> 

<_wcf :Address> 

<_wcf :AddressLine>1025 Cameron Ave SW</_wcf :AddressLine> 
<_wcf :AddressLine></_wcf :AddressLine> 

<_wcf :AddressLine></_wcf :AddressLine> 

<_wcf:City> Calgary</_wcf:City> 

<_wcf :StateOrProvinceName>Alberta</_wcf :StateOrProvinceName> 

<_wcf :Country>Canada</_wcf :Country> 

<_wcf : Postal Code>T2T 0K4</_wcf : Postal Code> 

</_wcf :Address> 

<_wcf :Telephonel publ i sh="true"> 

<_wcf :Val ue></_wcf :Val ue> 

</_wcf :Telephonel> 

<_wcf :Tel ephone2 publ i sh="true"> 

<_wcf :Val ue></_wcf :Val ue> 

</_wcf :Telephone2> 

<_wcf : Emai 1 Address 1> 

<_wcf : Val ue>admi n@madi sons . ca</_wcf : Val ue> 

</_wcf : Email Address 1> 

<_wcf : Emai 1 Address2> 

<_wcf :Val ue></_wcf :Val ue> 

</_wcf : Emai 1 Address2> 

<_wcf:Faxl> 

<_wcf :Val ue></_wcf : Val ue> 

</_wcf :Faxl> 

<_wcf:Fax2> 

<_wcf :Val ue></_wcf :Val ue> 
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</_wcf :Fax2> 

</_ord :Shi ppi ngAddress> 

<_ord : Shi ppi ngMode> 

<_ord:Shi ppi ngModeldenti f i er> 

<_ord : Uni queID>10001</_ord : Uni quel D> 

<_ord : External Identi f i er> 

<_ord:ShipModeCode>PickupInStore</_ord:ShipModeCode> 
</_ord : External Identi f i er> 

</_ord : Shi ppi ngModeldenti f i er> 

<_ord: Description language="-l">Pickup in 
store</_ord : Descri pti on> 

</_ord :Shi ppi ngMode> 

<_ord : Physical Storeldenti f i er> 

<_wcf : Uni quel D>10026</_wcf: Uni quel D> 

<_wcf : External Identi f i er>Cal gary 
Mai l</_wcf: External Identifier 

</_ord : Physical Storeldenti f i er> 

</_ord:OrderItemShippingInfo> 

<_ord:OrderItemStatus> 

<_ord : Status>P</_ord : Status> 

<_ord : InventoryStatus>Avai 1 abl e</_ord : InventoryStatus> 

<_ord : Ful f i 1 lmentStatus>Unrel eased</_ord: Ful f i 1 lmentStatus> 
</_ord:OrderItemStatus> 

<_ord :OrderItemFul f i 1 lmentInfo> 

<_ord:Avai 1 abl eDate>2009-08-llT16: 08:54. 609Z</_ord:Avai 1 abl eDate> 

<_ord:ExpectedShipDate>2009-08-llT16:09:27.921Z</_ord:ExpectedShipDate> 
</_ord:OrderItemFul fi 1 lmentInfo> 

<_ord : Ful f i 1 1 mentCenter> 

<_ord : Ful f i 1 1 mentCenterldenti f i er> 

<_wcf : Uni quel D>10076</_wcf: Uni quel D> 

<_wcf:Name>Calgary Mai l</_wcf :Name> 

</_ord : Ful f i 1 1 mentCenterldenti f i er> 

</_ord : Ful f i 1 lmentCenter> 

<_ord : Correl ati onGroup>45001</_ord : Correl ati onGroup> 

<_ord : CreateDate>2009-08- 1 1T15 : 36 : 06 . 781Z</_ord : CreateDate> 

<_ord : LastUpdateDate>2009-08- 1 1T16 : 08 : 52 . 812Z</_ord : LastUpdateDate> 
<_ord : Usabl eShi ppi ngChargePol i cy> 

<_wcf : Uni quel D>-7001</_wcf: Uni quel D> 

<_wcf: External Identifier 

<_wcf : Name>StandardShi ppi ngChargeBySel 1 er</_wcf : Name> 

<_wcf :Type>ShippingCharge</_wcf :Type> 

</_wcf: External Identifier 
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</_ord : Usabl eShi ppi ngChargePol i cy> 
</_ord:OrderItem> 

</_i nv : InventoryRequi rement> 
</_inv:DataArea> 

</_i nv : Process InventoryRequi rement> 


A.2 ProcessInventoryRequirement with 

action code Reservelnventory response 

Example A-2 shows the ProcessInventoryRequirement request with the action 
code Reservelnventory response. 

Example A-2 ProcessInventoryRequirement with action code Reservelnventory response 

<_i nv: Acknowl edgelnventoryRequi rement 

xml ns :xsi = "http: //www. w3.org/2001/XMLSchema- instance" 

xml ns :_i nv="http: //www. i bm. com/xml ns/prod/commerce/9/i nventory" 

xml ns :_ord="http: //www. ibm.com/xml ns/prod/commerce/9/order" 

xml ns :_wcf="http: //www. ibm. com/xml ns/prod/commerce/9/foundati on" 

xml ns :oa=" http: //www. openappl i cations.org/oagi s/9" releaseID="9.0"> 

<oa:Appl icationArea xsi :type="_wcf : Appl icationAreaType"> 
<oa:CreationDateTime>2009-08-llT16:09:31 .953Z</oa:CreationDateTime> 
<oa:B0DID>5a489660-8691-llde-845f-84214a818784</oa:B0DID> 

</oa:ApplicationArea> 

<_inv:DataArea> 

<oa:Acknowledge> 

<oa :0ri gi nal Appl i cati onArea> 

<oa: Creati onDateTime>2009-08- 1 1T16 : 09 : 28. 218Z</oa : Creati onDateTime> 
<oa:B0DID>58111cf 0-869 l-llde-845f-84214a818784</oa:B0DID> 

</oa:Original Appl icationArea> 

</oa:Acknowledge> 

<_i nv : InventoryRequi rement shi pAsCompl ete="true"> 

<_ord: Order Identifier 
<_wcf : Uni quel D>12501</_wcf: Uni quel D> 

</_ord :0rderldenti f i er> 

<_ord:StoreIdentifier> 

<_wcf : Uni quel D>10001</_wcf: Uni quel D> 

<_wcf: External Identifier 

<_wcf : Nameldenti f i erMadi sons</_wcf : Nameldenti f i er 
</_wcf: External Identifier 
</_ord : Storeldenti f i er 
<_ord : Buyerldenti f i er 
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<_wcf : Uni quel D>2</_wcf: Uni quel D> 

<_wcf : Di sti ngui shedName>ui d=wangf ul , o=defaul t organi zati on ,o=root 
organi zati on</_wcf : Di sti ngui shedName> 

</_ord : Buyerldenti f i er> 

<_ord : OrderAmount> 

<_wcf :GrandTotal currency="USD">323.99000</_wcf :GrandTotal> 

<_wcf :Total ProductPrice currency="USD">449.99000</_wcf :Total ProductPri ce> 
<_wcf: Total Adjustment currency="USD">-126.00000</_wcf : Total Ad justment> 

<_wcf :Adjustment> 

<_wcf :Usage>Discount</_wcf :Usage> 

<_wcf :Code>Furniture Category Di scount</_wcf :Code> 

<_wcf :Description 1 anguage="-l">Save 20% on Furniture !</_wcf :Description> 
<_wcf: Amount currency="USD">-90.00000</_wcf :Amount> 

<_wcf : Display Level >0rder I tem</_wcf : Display Level > 

</_wcf : Adjustment 
<_wcf :Adjustment> 

<_wcf :Usage>Discount</_wcf :Usage> 

<_wcf :Code>Save 10% on all orders today</_wcf :Code> 

<_wcf :Description 1 anguage="-l">Save 10% on all orders</_wcf :Description> 
<_wcf: Amount currency="USD">-36.00000</_wcf :Amount> 

<_wcf : Di spl ay Level >0rder</_wcf: Di spl ay Level > 

</_wcf : Adjustment 

<_wcf: Total Shi ppi ngCharge currency="USD">0.00000</_wcf : Total Shi ppi ngCharge> 
<_wcf: Total Sal esTax currency="USD">0.00000</_wcf : Total Sal esTax> 

<_wcf : Total Shi ppi ngTax currency="USD">0.00000</_wcf : Total Shi ppi ngTax> 

</_ord : OrderAmount> 

<_ord : Order Payment I nf o/> 

<_ord:OrderStatus preparelndi cator="fal se"> 

<_ord : Status>P</_ord : Status> 

</_ord : OrderStatus> 

<_ord : Las tUpdateDate>2009-08- 1 1T16 : 08 : 52 . 687Z</_ord : Las tUpdateDate> 
<_ord:0rderltem> 

<_ord :0rderltemldenti f i er> 

<_wcf : Uni quel D>45001</_wcf: Uni quel D> 

</_ord : Order I temldenti f i er> 

<_ord : Catal ogEntry Identi f i er> 

<_wcf : Uni quel D>10002</_wcf: Uni quel D> 

<_wcf: External Identifier 
<_wcf :PartNumber>FUL0-0101</_wcf :PartNumber> 

</_wcf: External Identifier 
</_ord : Catal ogEntry Identi f i er 
<_ord : Quant i ty uom= "C62 ">1 . 0</_ord : Quant i ty> 

<_ord : Contract Identi f i er 
<_wcf : Uni quel D>10001</_wcf: Uni quel D> 

</_ord: Contract Identifier 
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<_ord : Of f er I D>10002</_ord : Of f erl D> 

<_ord:OrderItemShippingInfo expedite="fal se"> 

<_ord :Shi ppi ngAddress> 

<_wcf : Contact InfoIdentifier> 

<_wcf : Uni quel D>10076</_wcf: Uni quel D> 

<_wcf: External Identifier 

<_wcf: Contact I nfoNickName>Calgary Mai l</_wcf : Contact Inf oNickName> 
</_wcf: External Identifier 
</_wcf : Contact Infoldentifier 
<_wcf :ContactName> 

<_wcf : PersonT i tl e></_wcf : PersonT i t 1 e> 

<_wcf :LastName>Calgary Mai l</_wcf :LastName> 

<_wc f : Fi r s t N ame></_wc f : Fi r s t N ame> 

<_wcf : Mi ddl eName></_wcf :Mi ddl eName> 

</_wcf :ContactName> 

<_wcf :Address> 

<_wcf :AddressLine>1025 Cameron Ave SW</_wcf :AddressLine> 

<_wcf :AddressLine></_wcf :AddressLine> 

<_wcf :AddressLine></_wcf :AddressLine> 

<_wcf:City> Calgary</_wcf:City> 

<_wcf :StateOrProvinceName>Al berta</_wcf :StateOrProvi nceName> 

<_wcf :Country>Canada</_wcf :Country> 

<_wcf : Postal Code>T2T 0K4</_wcf: Postal Code> 

</_wcf :Address> 

<_wcf :Telephonel publ i sh="true"> 

<_wcf :Val ue></_wcf :Val ue> 

</_wcf :Telephonel> 

<_wcf :Tel ephone2 publ i sh="true"> 

<_wcf :Val ue></_wcf :Val ue> 

</_wcf :Telephone2> 

<_wcf: Email Address 1> 

<_wcf : Val ue>admi n@madi sons . ca</_wcf : Val ue> 

</_wcf: Email Address 1> 

<_wcf : Emai 1 Address2> 

<_wcf : Val ue></_wcf :Val ue> 

</_wcf : Emai 1 Address2> 

<_wcf :Faxl> 

<_wcf :Val ue></_wcf :Val ue> 

</_wcf :Faxl> 

<_wcf :Fax2> 

<_wcf : Val ue></_wcf :Val ue> 

</_wcf :Fax2> 

</_ord:ShippingAddress> 

<_ord :Shi ppi ngMode> 

<_ord : Shi ppi ngModeldenti f i er 
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<_ord : Uni queID>10001</_ord : Uni quel D> 

<_ord : External Identi f i er> 

<_ord:ShipModeCode>PickupInStore</_ord:ShipModeCode> 

</_ord : External Identi f i er> 

</_ord : Shi ppi ngModeldenti f i er> 

<_ord: Description language="-l">Pickup in store</_ord:Description> 
</_ord : Shi ppi ngMode> 

<_ord : Physical Storeldenti f i er> 

<_wcf : Uni quel D>10026</_wcf: Uni quel D> 

<_wcf: External Identi fier>Calgary Mai l</_wcf: External Identifier 
</_ord : Physical Storeldenti f i er> 

</_ord :OrderItemShi ppi ngInfo> 

<_ord:OrderItemStatus> 

<_ord :Status>P</_ord : Status> 

<_ord:InventoryStatus>Al located</_ord: InventoryStatus> 

<_ord:Ful fi 1 lmentStatus>Unreleased</_ord:Ful fi 1 lmentStatus> 
</_ord:OrderItemStatus> 

<_ord :OrderItemFul f i 1 lmentInfo> 

<_ord:Avai 1 ableDate>2009-08-llT16:09:31.468Z</_ord:Avai lableDate> 

<_ord : ExpectedShi pDate>2009-08- 1 1T16 : 09 : 27 . 92 lZ</_ord : ExpectedShi pDate> 
</_ord:OrderItemFul fi 1 lmentInfo> 

<_ord : Ful f i 1 1 mentCenter> 

<_ord:Ful fi 1 lmentCenterIdentifier> 

<_wcf : Uni quel D>10076</_wcf: Uni quel D> 

<_wcf :Name>Calgary Mai l</_wcf :Name> 

</_ord : Ful f i 1 1 mentCenter Identi f i er> 

</_ord : Ful f i 1 lmentCenter> 

<_ord : Correl ati onGroup>45001</_ord : Correl ati onGroup> 

<_ord : CreateDate>2009-08- 1 1T15 : 36 : 06 . 781Z</_ord : CreateDate> 

<_ord : LastUpdateDate>2009-08- 1 1T16 : 08:52 . 812Z</_ord : LastUpdateDate> 

<_ord : Usabl eShi ppi ngChargePol i cy> 

<_wcf : Uni quel D>-7001</_wcf: Uni quel D> 

<_wcf: External Identifier 

<_wcf :Name>StandardShippingChargeBySel ler</_wcf :Name> 

<_wcf :Type>ShippingCharge</_wcf :Type> 

</_wcf: External Identifier 
</_ord : Usabl eShi ppi ngChargePol i cy> 

</_ord:0rderItem> 

</_i nv : InventoryRequi rement> 

</_inv:DataArea> 

</_inv:AcknowledgeInventoryRequirement> 
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A.3 Processlnventory with 

action code CancellnventoryReservation request 

Example A-3 shows the ProcessInventoryRequirement with the action code 
Cancel InventoryReservation request. 

Example A-3 ProcessInventoryRequirement with action code CancellnventoryReservation request 

<_inv: ProcessInventoryRequirement releaseID="9.0" vers i on I D= "6. 0.0. 4" 

xml ns :_i nv="http: //www. i bm. com/xml ns/prod/commerce/9/i nventory" 

xml ns :_ord="http: //www. ibm. com/xml ns/prod/commerce/9/order" 

xml ns :_wcf="http: //www. ibm. com/xml ns/prod/commerce/9/foundation" 

xml ns :oa=" http: //www. openappl i cations.org/oagi s/9" 

xml ns :xsi = "http://www.w3.org/2001/XMLSchema-instance"> 

<oa:Appl icationArea xsi :type="_wcf : Appl icationAreaType"> 

<oa : Creat i onDateTime>2009-04-02T08 : 28 : 47 . 7 18Z</oa : Creat i onDateT i me> 
<oa:B0DID>4929ef20-lf60-llde-8f9a-834749d4773b</oa:B0DID> 

<_wcf :BusinessContext> 

<_wcf :ContextData name="l angld">-l</_wcf :ContextData> 

<_wcf :ContextData name="storeId">553</_wcf :ContextData> 

</_wcf :BusinessContext> 

</oa:ApplicationArea> 

<_inv:DataArea> 

<oa:Process> 

<oa:ActionCriteria> 

<oa:ActionExpression actionCode="Cancel InventoryReservation" 
expressionLanguage="_wcf :XPath">/InventoryRequirement[l]</oa:ActionExpression> 

</oa : Acti onCri teri a> 

</oa:Process> 

<_i nv : InventoryRequi rement> 

<_ord: Order Identifier 
<_wcf : Uni quel D>14507</_wcf: Uni quel D> 

</_ord :0rderldenti f i er> 

<_ord:StoreIdentifier> 

<_wcf : Uni quel D>553</_wcf: Uni quel D> 

</_ord : Storeldenti f i er> 

<_ord : Buyerldenti f i er> 

<_wcf : Uni quel D>100000000501</_wcf : Uni quel D> 

<_wcf :DistinguishedName>uid=user,ou=extended sites seller organizationsample 
b2c store, o=extended sites seller organization, o=root 
organi zati on</_wcf : Di sti ngui shedName> 

</_ord : Buyerldenti f i er> 

<_ord:OrderStatus preparelndi cator="fal se"> 

<_ord : Status>P</_ord : Status> 


464 Building Multichannel Applications with WebSphere Commerce 



</_ord : OrderStatus> 

<_ord : Las tllpdateDate>2009-01- 13T09 : 57 : 33 . 420Z</_ord : Las tUpdateDate> 
<_ord : PI acedDate>2009-01- 13T09 : 57 : 33 . 420Z</_ord : PI acedDate> 
<_ord:0rderltem> 

<_ord :OrderItemIdenti f i er> 

<_wcf : Uni quel D>10045007</_wcf: Uni quel D> 

</_ord:OrderItemIdentifier> 

<_ord : Catal ogEntry Identi f i er> 

<_wcf : Uni quel D>5530 1088100</_wcf : Uni quel D> 

</_ord : Catal ogEntry Identi fi er> 

<_ord : Quant i ty>2 . 0</_ord :Quanti ty> 

<_ord : Contract Identi f i er> 

<_wcf : Uni quel D>50300000003</_wcf : Uni quel D> 

</_ord: Contract Identifier 
<_ord:0fferID>55301088100</_ord:0fferID> 

<_ord :OrderItemAmount freeGi ft="fal se"> 

<_wcf :UnitPrice> 

<_wcf : Pri ce currency="USD">55 .00000</_wcf : Pri ce> 

<_wcf Quantity uom="C62">1.0</_wcf : Quant ity> 

</_wcf:UnitPrice> 

<_wcf : Order ItemPrice currency="USD">110.00000</_wcf :OrderItemPri ce> 
<_wcf :ShippingCharge currency="USD">0.00000</_wcf : Shi ppi ngCharge> 
<_wcf :SalesTax currency="USD">0.00000</_wcf : Sal esTax> 

<_wcf :ShippingTax currency="USD">0.00000</_wcf : Shi ppi ngTax> 

</_ord : Order I temAmount> 

<_ord:OrderItemShippingInfo expedi te="fal se"> 

<_ord :Shi ppi ngAddress> 

<_wcf : Contact InfoIdentifier> 

<_wcf : Uni quel D>100000000051</_wcf: Uni quel D> 

<_wcf: External Identifier 

<_wcf :ContactInfoNickName>user</_wcf :ContactInfoNickName> 
</_wcf: External Identifier 
</_wcf: Contact Infoldentifier 
<_wcf :ContactName> 

<_wcf :PersonTitle/> 

<_wcf : LastName>user</_wcf : LastName> 

<_wcf :FirstName/> 

<_wcf :MiddleName/> 

</_wcf :ContactName> 

<_wcf :Address> 

<_wcf: Address Li ne>as</_wcf: Address Li ne> 

<_wcf :AddressLine/> 

<_wcf :AddressLine/> 

<_wc f : C i ty>s a</_wc f : C i ty> 

<_wcf :StateOrProvinceName>aa</_wcf :StateOrProvinceName> 
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<_wcf :Country>AF</_wcf :Country> 

<_wcf: Postal Code>ss</_wcf : Postal Code> 

</_wcf :Address> 

<_wcf :Telephonel publ i sh="true"> 

<_wcf :Val ue/> 

</_wcf :Telephonel> 

<_wcf :Tel ephone2 publ i sh="true"> 

<_wcf :Val ue/> 

</_wcf :Telephone2> 

<_wcf: Email Address 1> 

<_wcf :Val ue/> 

</_wcf: Email Address 1> 

<_wcf : Emai 1 Address2> 

<_wcf :Val ue/> 

</_wcf : Emai 1 Address2> 

<_wcf :Faxl> 

<_wcf :Val ue/> 

</_wcf :Faxl> 

<_wcf :Fax2> 

<_wcf :Val ue/> 

</_wcf :Fax2> 

</_ord:ShippingAddress> 

<_ord :Shi ppi ngMode> 

<_ord : Shi ppi ngModeldenti f i er> 

<_ord : Uni queID>5030051</_ord : Uni queID> 

</_ord : Shi ppi ngModeldenti f i er> 

<_ord : Descri pti on 1 anguage=" - 1 ">Mai 1 </_ord : Descri pti on> 

</_ord : Shi ppi ngMode> 

</_ord :OrderItemShi ppi ngInfo> 

<_ord:OrderItemStatus> 

<_ord :Status>M</_ord : Status> 

<_ord:InventoryStatus>Al located</_ord: InventoryStatus> 

<_ord:Ful fi 1 lmentStatus>Unreleased</_ord:Ful fi 1 lmentStatus> 
</_ord:OrderItemStatus> 

<_ord :OrderItemFul f i 1 1 ment Info> 

<_ord : ExpectedShi pDate>2009-01- 13T09 : 57 : 54 . 578Z</_ord : ExpectedShi pDate> 
</_ord:OrderItemFul fi 1 lmentInfo> 

<_ord : Ful f i 1 1 mentCenter> 

<_ord:Ful fi 1 lmentCenterIdentifier> 

<_wcf :UniqueID/> 

</_ord : Ful f i 1 1 mentCenterldenti f i er> 

</_ord : Ful f i 1 lmentCenter> 

</_ord:OrderItem> 

</_i nv : InventoryRequi rement> 

</_inv:DataArea> 

</_i nv : Process InventoryRequi rement> 
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A.4 ProcessInventoryRequirement with action code 
CancellnventoryReservation response 

Example A-4 shows the ProcessInventoryRequirement with the action code 
Cancel InventoryReservation response. 

Example A-4 ProcessInventoryRequirement with action code CancellnventoryReservation response 

<_i nv: Acknowl edgelnventoryRequi rement rel easeID="9.0" 

xml ns :_i nv="http: //www. i bm. com/xml ns/prod/commerce/9/i nventory" 

xml ns :_ord="http: //www. ibm. com/xml ns/prod/commerce/9/order" 

xml ns :_wcf="http: //www. ibm. com/xml ns/prod/commerce/9/foundation" 

xml ns :oa=" http: //www. openappl i cations.org/oagi s/9" 

xml ns :xsi = "http://www.w3.org/2001/XMLSchema-instance"> 

<oa:Appl icationArea xsi :type="_wcf : Appl icationAreaType"> 

<oa : Creati onDateTime>2009-04-02T17 :23 : 34 .608Z</oa : Creati onDateTime> 
<oa:B0DID>fe70f2d0-lfaa-llde-9dd0-827f49d4eflb</oa:B0DID> 

</oa:ApplicationArea> 

<_inv:DataArea> 

<oa:Acknowledge> 

<oa :0ri gi nal Appl i cati onArea> 

<oa:CreationDateTime>2009-04-02T08:28:47.718Z</oa:CreationDateTime> 

<oa:B0DID>4929ef20-lf60-llde-8f9a-834749d4773b</oa:B0DID> 

</oa:OriginalAppl icationArea> 

</oa:Acknowledge> 

<_i nv : InventoryRequi rement shi pAsCompl ete="fal se"> 

<_ord: Order Identifier 
<_wcf : Uni quel D>14507</_wcf: Uni quel D> 

</_ord :0rderldenti f i er> 

<_ord:StoreIdentifier> 

<_wcf : Uni quel D>553</_wcf: Uni quel D> 

</_ord : Storeldenti f i er> 

<_ord : Buyerldenti f i er> 

<_wcf : Uni quel D>100000000501</_wcf : Uni quel D> 

<_wcf :DistinguishedName>uid=user,ou=extended sites seller organizationsample 
b2c store, o=extended sites seller organization, o=root 
organi zati on</_wcf : Di sti ngui shedName> 

</_ord : Buyerldenti f i er> 

<_ord:OrderStatus preparelndi cator="fal se"> 

<_ord : Status>P</_ord : Status> 

</_ord:OrderStatus> 

<_ord : LastUpdateDate>2009-01- 13T09 : 57 : 33 . 420Z</_ord : LastUpdateDate> 

<_ord : PI acedDate>2009-01- 13T09 : 57 : 33 . 420Z</_ord : PI acedDate> 

<_ord:0rderltem> 
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<_ord :OrderItemIdenti f i er> 

<_wcf : Uni quel D>10045007</_wcf : Uni quel D> 

</_ord : Order I temldenti f i er> 

<_ord:OrderItemStatus> 

<_ord :Status>M</_ord : Status> 

<_ord:InventoryStatus>Unal located</_ord:InventoryStatus> 
</_ord:OrderItemStatus> 

<_ord :OrderItemFul f i 1 lmentInfo/> 

<_ord : Ful f i 1 1 mentCenter> 

<_ord:Ful fi 1 lmentCenterIdentifier> 

<_wcf : Uni queID/> 

<_wcf :Name/> 

</_ord : Ful f i 1 1 mentCenterldenti f i er> 

</_ord : Ful f i 1 lmentCenter> 

</_ord:OrderItem> 

</_i nv : InventoryRequi rement> 

</_inv:DataArea> 

</_inv:Acknowledge!nventoryRequirement> 


A.5 ProcessOrder with action code TransferOrder 
request 

Example A-5 shows the ProcessOrder with the action code TransferOrder 
request. 

Example A-5 ProcessOrder with action code TransferOrder request sample 

<_ord: ProcessOrder releaseID="9.0" versionID="7. 0.0.0" 
xml ns :_ord=" http: //www. ibm.com/xml ns/prod/commerce/9/order" 
xml ns :_wcf=" http: //www. ibm.com/xml ns/prod/commerce/9/foundation"> 
<oa:Appl icationArea xsi :type="_wcf : Appl icationAreaType"> 
<oa:CreationDateTime 

xsi :type="udt:DateType">2009-08-ll</oa:CreationDateTime> 

<oa: BODI D>20aed7 10-8692- llde-845f-84214a818784</oa:B0DID> 
<_wcf :BusinessContext/> 

</oa:Appl icationArea> 

<_ord : DataArea> 

<oa:Process> 

<oa:ActionCriteria> 

<oa:ActionExpression act ionCode= "TransferOrder" 
expressionLanguage="_wcf :XPath">/Order</oa:ActionExpression> 
</oa:ActionCriteria> 
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</oa:Process> 

<_ord:Order shi pAsCompl ete="true"> 

<_ord :0rderldenti f i er> 

<_wcf : Uni quel D>12501</_wcf : Uni quel D> 

</_ord:OrderIdentifier> 

<_ord : Storeldenti f i er> 

<_wcf : Uni quel D>10001</_wcf : Uni quel D> 

<_wcf: External Identifier 

<_wcf : Nameldenti f i er>Madi sons</_wcf : Nameldenti f i er> 

</_wcf: External Identifier 
</_ord: Storeldenti fier 
<_ord : Buyerldenti f i er 
<_wcf : Uni quel D>2</_wcf: Uni quel D> 

<_wcf : Di sti ngui shedName>ui d=wangf ul , o=def aul t 
organi zati on , o=root organi zati on</_wcf : Di sti ngui shedName> 

</_ord : Buyerldenti f i er 
<_ord:OrderAmount> 

<_wcf :GrandTotal currency="USD">323.99000</_wcf :GrandTotal> 
<_wcf :Total ProductPrice 

currency="USD">449.99000</_wcf: Total Product Pri ce> 

<_wcf : Total Adjustment 

currency= "USD">- 126 . 00000</_wcf : Total Adj ustment> 

<_wcf : Adjustment 
<_wcf :Usage>Discount</_wcf :Usage> 

<_wcf :Code>Furniture Category Di scount</_wcf :Code> 

<_wcf: Description language="-l">Save 20% on 
Furniture !</_wcf : Descript ion> 

<_wcf: Amount currency="USD">-90.00000</_wcf :Amount> 
<_wcf:DisplayLevel 

xsi :type="_wcf :DisplayLevel EnumerationType">OrderItem</_wcf : Di spl ayLeve 
1 > 

</_wcf :Adjustment> 

<_wcf :Adjustment> 

<_wcf :Usage>Discount</_wcf :Usage> 

<_wcf :Code>Save 10% on all orders today</_wcf :Code> 

<_wcf: Description language="-l">Save 10% on all 
orders</_wcf :Description> 

<_wcf: Amount currency="USD">-36.00000</_wcf :Amount> 
<_wcf:DisplayLevel 

xsi :type="_wcf :DisplayLevel EnumerationType">Order</_wcf : Display Level > 
</_wcf :Adjustment> 

<_wcf :Total Shi ppi ngCharge 
currency="USD">0.00000</_wcf :Total Shi ppi ngCharge> 

<_wcf :Total Sal esTax 

currency="USD">0.00000</_wcf :Total Sal esTax> 
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<_wcf :Total Shi ppi ngTax 

currency="USD">0.00000</_wcf :Total Shi ppi ngTax> 

</_ord : OrderAmount> 

<_ord : Order Payment I nf o> 

<_ord : Payment Instructi on> 

<_ord : Uni quel D>12001</_ord : Uni quel D> 

<_ord: Amount currency="USD">323.99000</_ord:Amount> 
<_ord : PaymentMethod> 

<_ord:PaymentMethodName>PayInStore</_ord:PaymentMethodName> 

<_ord: Description language="-l">Pay In 

Store</_ord : Descri pti on> 

</_ord : PaymentMethod> 

<_ord: Protocol Data 

name="payment_method">PayInStore</_ord: Protocol Data> 

</_ord: Payment I nstruction> 

</_ord:OrderPaymentInfo> 

<_ord:OrderStatus preparelndi cator="true"> 

<_ord: Status 

xsi : type="_ord : OrderLi feCycl eStatusEnumerati onType">M</_ord : Status> 
</_ord : OrderStatus> 

<_ord : LastUpdateDate>2009-08- 1 1T16 : 10 : 02 . 890Z</_ord : LastUpdateDate> 
<_ord : PI acedDate>2009-08-l 1T16 : 10 : 02 .890Z</_ord : PI acedDate> 
<_ord:0rderltem> 

<_ord:0rderltemldentifier> 

<_wcf : Uni quel D>45001</_wcf: Uni quel D> 

</_ord :0rderltemldenti f i er> 

<_ord : Catal ogEntryldenti f i er> 

<_wcf : Uni quel D>10002</_wcf: Uni quel D> 

<_wcf : External Identi f i er> 

<_wcf : PartNumber>FUL0-0101</_wcf : PartNumber> 

</_wcf: External Identifier 
</_ord :Catal ogEntryldenti f i er> 

<_ord : Quant i ty uom="C62">l . 0</_ord :Quanti ty> 

<_ord : Contract Identi f i er> 

<_wcf : Uni quel D>10001</_wcf: Uni quel D> 

</_ord: Contract Identifier 
<_ord:0fferID>10002</_ord:0fferID> 

<_ord :OrderItemAmount freeGi ft="fal se"> 

<_wcf:UnitPrice> 

<_wcf : Pri ce currency="USD">449 .99000</_wcf : Pri ce> 
<_wcf: Quantity uom="C62">1.0</_wcf : Quant ity> 

</_wcf :UnitPrice> 
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<_wcf :OrderItemPrice 

currency="USD">449.99000</_wcf :OrderItemPrice> 

<_wcf :Adjustment> 

<_wcf :Usage>Discount</_wcf :Usage> 

<_wcf :Code>Furniture Category Di scount</_wcf :Code> 

<_wcf: Description language="-l">Save 20% on 
Furniture !</_wcf : Descript ion> 

<_wcf: Amount currency="USD">-90.00000</_wcf :Amount> 

<_wcf :DisplayLevel 

xsi :type="_wcf :DisplayLevel EnumerationType">OrderItem</_wcf : Di spl ayLeve 
1 > 

</_wcf : Ad j ustment> 

<_wcf :Adjustment> 

<_wcf :Usage>Discount</_wcf :Usage> 

<_wcf :Code>Save 10% on all orders today</_wcf :Code> 

<_wcf: Description language="-l">Save 10% on all 
orders</_wcf :Description> 

<_wcf: Amount currency="USD">-36.00000</_wcf :Amount> 

<_wcf :DisplayLevel 

xsi :type="_wcf :DisplayLevel EnumerationType">Order</_wcf : Display Level > 
</_wcf : Ad j ustment> 

<_wcf : Shi ppi ngCharge 

currency="USD">0.00000</_wcf :Shi ppi ngCharge> 

<_wcf :SalesTax currency="USD">0.00000</_wcf :Sal esTax> 

<_wcf :ShippingTax currency="USD">0.00000</_wcf :ShippingTax> 
</_ord:OrderItemAmount> 

<_ord:OrderItemShippingInfo expedite="fal se"> 
<_ord:ShippingAddress> 

<_wcf :ContactInfoIdentifier> 

<_wcf : Uni quel D>10076</_wcf: Uni queID> 

<_wcf: External Identifier 
<_wcf :ContactInfoNi ckName>Cal gary 
Mai l</_wcf :ContactInfoNickName> 

</_wcf: External Identifier 
</_wcf :ContactInfoIdentifier> 

<_wcf :ContactName> 

<_wcf : PersonT i tl e></_wcf : PersonT i tl e> 

<_wcf :LastName>Calgary Mai l</_wcf :LastName> 

<_wcf : First Name></_wcf : First Name> 

<_wcf :Mi ddl eName></_wcf :Mi ddl eName> 

</_wcf :ContactName> 

<_wcf :Address> 

<_wcf :AddressLine>1025 Cameron Ave 
SW</_wcf :AddressLine> 

<_wcf :AddressLine></_wcf :AddressLine> 
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<_wcf :AddressLine></_wcf :AddressLine> 

<_wcf:City> Cal gary</_wcf :City> 

<_wcf :StateOrProvinceName>Alberta</_wcf :StateOrProvinceName> 

<_wcf :Country>Canada</_wcf :Country> 

<_wcf: Postal Code>T2T 0K4</_wcf: Postal Code> 

</_wcf :Address> 

<_wcf :Telephonel publ i sh="true"> 

<_wcf :Val ue></_wcf :Val ue> 

</_wcf :Telephonel> 

<_wcf :Telephone2 publ i sh="true"> 

<_wcf :Val ue></_wcf :Val ue> 

</_wcf :Telephone2> 

<_wcf: Email Address 1> 

<_wcf : Val ue>admi n@madi sons . ca</_wcf : Val ue> 

</_wcf : Emai 1 Addressl> 

<_wcf : Emai 1 Address2> 

<_wcf :Val ue></_wcf :Val ue> 

</_wcf : Emai 1 Address2> 

<_wcf :Faxl> 

<_wcf :Val ue></_wcf :Val ue> 

</_wcf :Faxl> 

<_wcf :Fax2> 

<_wcf :Val ue></_wcf :Val ue> 

</_wcf :Fax2> 

</_ord : Shi ppi ngAddress> 

<_ord : Shi ppi ngMode> 

<_ord : Shi ppi ngModeldenti f i er> 

<_ord : Uni quel D>10001</_ord : Uni queID> 

<_ord : External Identi f i er> 

<_ord:ShipModeCode>PickupInStore</_ord:ShipModeCode> 
</_ord: External Identifier 
</_ord : Shi ppi ngModeldenti f i er> 

<_ord: Description language="-l">Pickup in 
store</_ord : Descri pti on> 

</_ord : Shi ppi ngMode> 

<_ord: Physi cal Storeldenti f ier> 

<_wcf : Uni quel D>10026</_wcf: Uni quel D> 

<_wcf: External Identi f i er>Cal gary 
Mai l</_wcf: External Identifier 

</_ord : Physical Storeldenti f i er 
</_ord :OrderItemShi ppi ngInfo> 

<_ord:OrderItemStatus> 

<_ord: Status 

xsi :type="_ord:OrderItemLifeCycleStatusEnumerationType">M</_ord:Status> 
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<_ord: InventoryStatus 

xsi :type="_ord: InventoryStatusEnumerationType">Al located</_ord: Inventor 

yStatus> 

<_ord : Ful f i 1 1 mentStatus 

xsi :type="_ord:Ful fi 1 1 mentStatus EnumerationType">Unreleased</_ord: Ful fi 

1 lmentStatus> 

</_ord:OrderItemStatus> 

<_ord : Order ItemFul f i 1 lmentInfo> 

<_ord : Avai 1 abl eDate>2009-08- 11T16: 09:31. 468Z</_ord : Avai 1 abl eDate> 

<_ord : ExpectedShi pDate>2009-08- 1 1T16 : 15 : 03 . 640Z</_ord : ExpectedShi pDate> 
</_ord:OrderItemFul fi 1 lmentInfo> 

<_ord : Ful f i 1 1 mentCenter> 

<_ord:Ful fi 1 lmentCenterIdentifier> 

<_wcf : Uni quel D>10076</_wcf: Uni quel D> 

<_wcf :Name>Calgary Mai l</_wcf :Name> 

</_ord : Ful f i 1 1 mentCenterldenti f i er> 

</_ord : Ful f i 1 1 mentCenter> 

<_ord : Correl ati onGroup>45001</_ord :Correl ati onGroup> 

<_ord : CreateDate>2009-08- 1 1T15 : 36 : 06 . 781Z</_ord : CreateDate> 

<_ord : LastUpdateDate>2009-08- 1 1T16 : 10 : 02 . 890Z</_ord : LastUpdateDate> 
<_ord : Usabl eShi ppi ngChargePol i cy> 

<_wcf : Uni quel D>-7001</_wcf: Uni quel D> 

<_wcf : External Identi f i er> 

<_wcf :Name>StandardShippingChargeBySel ler</_wcf :Name> 
<_wcf :Type>ShippingCharge</_wcf :Type> 

</_wcf: External Identifier 
</_ord :Usabl eShi ppi ngChargePol i cy> 

</_ord:0rderItem> 

</_ord: Order 
</_ord:DataArea> 

</_ord : ProcessOrder 
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A.6 ProcessOrder with action code TransferOrder 
response 

Example A-6 shows the ProcessOrder with the action code TransferOrder 
response. 

Example A-6 ProcessOrder with action code TransferOrder response 
<_ord:AcknowledgeOrder 

xml ns :_ord=" http: //www. ibm.com/xml ns/prod/commerce/9/order" 
xml ns :_wcf=" http: //www. ibm.com/xml ns/prod/commerce/9/foundation"> 
<oa:Appl icationArea> 

<oa:CreationDateTime 

xsi :type="udt:DateTimeType">2009-08-llT16: 15:06Z</oa:CreationDateTime> 
</oa:Appl icationArea> 

<_ord : DataArea> 

<oa:Acknowledge/> 

<_ord:0rder> 

<_ord :0rderldenti f i er> 

<_wcf : Uni quel D>12501</_wcf: Uni quel D> 

</_ord:OrderIdentifier> 

</_ord:Order> 

</_ord:DataArea> 

</_ord:AcknowledgeOrder> 


A.7 SyncOrder request 

Example A-7 shows a SyncOrder request. 

Example A-7 SyncOrder request 

<_ord: SyncOrder rel easeID="9.0" versionID="6.0.0.6" 

xml ns :_ord=" http: //www. ibm.com/xml ns/prod/commerce/9/order" 

xml ns :_wcf=" http: //www. ibm.com/xml ns/prod/commerce/9/foundation" 

xml ns :oa=" http: //www. openappl icati ons.org/oagi s/9"> 

<oa:Appl icationArea xsi :type="_wcf : Appl icati onAreaType"> 

<oa : Creat i onDateTime>2009-08-06T02 : 36 : 47 . 578Z</oa : Creat i onDateT i me> 
<oa:B0DID>fc925370-8231-llde-b571-81ff4a7a41bf</oa:B0DID> 

<_wcf :BusinessContext> 

<_wcf :ContextData name="l angld">-l</_wcf :ContextData> 

<_wcf :ContextData name="storeld">0</_wcf :ContextData> 

</_wcf :BusinessContext> 

</oa:ApplicationArea> 
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<_ord : DataArea> 

<oa:Sync> 

<oa:ActionCriteria> 

<oa:ActionExpression act ionCode= "Change" 
expressionLanguage="_wcf :XPath"/> 

</oa : Acti onCri teri a> 

</oa:Sync> 

<_ord:0rder> 

<_ord : Orderldenti f i er> 

<_wcf : Uni quel D>17010</_wcf : Uni quel D> 
</_ord : Orderldenti f i er> 

<_ord : OrderAmount/> 

<_ord:OrderStatus> 

<_ord : Status>E</_ord : Status> 

</_ord : OrderStatus> 

<_ord:0rderltem> 

<_ord :OrderItemIdenti f i er> 

<_wcf : Uni quel D>10070050</_wcf: Uni quel D> 
</_ord : Order I temldenti f i er> 
<_ord:OrderItemAmount/> 
<_ord:OrderItemShippingInfo/> 
<_ord:OrderItemStatus> 

<_ord : Status>E</_ord : Status> 
</_ord:OrderItemStatus> 

</_ord:OrderItem> 

<_wcf :UserData/> 

</_ord:Order> 

</_ord:DataArea> 

</_ord:SyncOrder> 


A.8 SyncOrder response 

Example A-8 shows the contents of the 

Process I nventoryReqmt_UpdateInventoryReservationReq.xsl file. 

Example A-8 SyncOrder response 
<oa:ConfirmBOD releaseID="9.0" 

xml ns :_wcf=" http: //www. ibm.com/xml ns/prod/commerce/9/foundation" 
xml ns :oa=" http: //www. openappl icati ons.org/oagi s/9"> 

<oa:Appl icationArea xsi :type="_wcf : Appl icati onAreaType"> 
<oa:CreationDateTime>2009-08-06T16:44:37.862Z</oa:CreationDateTime> 
<oa:B0DID>6d720880-82a8-llde-85cd-861d4a788c3a</oa:B0DID> 
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</oa:ApplicationArea> 

<oa:DataArea> 

<oa:Confirm> 

<oa :Ori gi nal Appl i cati onArea> 
<oa:CreationDateTime>2009-08-06Z</oa:CreationDateTime> 
<oa:B0DID>fc925370-8231-llde-b571-81ff4a7a41bf</oa:B0DID> 
</oa:Original Appl icationArea> 

</oa:Confirm> 

<oa:BOD> 

<oa : Original Appl i cati onArea xsi :type="_wcf : Appl i cati onAreaType"> 
<oa:CreationDateTime>2009-08-06Z</oa:CreationDateTime> 
<oa:B0DID>fc925370-8231-llde-b571-81ff4a7a41bf</oa:B0DID> 

<_wcf :BusinessContext> 

<_wcf :ContextData name="l angld">-l</_wcf :ContextData> 

<_wcf :ContextData name="storeld">0</_wcf :ContextData> 

</_wcf :BusinessContext> 

</oa:Original Appl icationArea> 

<oa:BODSuccessMessage/> 

</oa:BOD> 

</oa:DataArea> 

</oa:ConfirmBOD> 
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A.9 ProcesslnventoryReqmt_Updatelnventory 
ReservationsReq.xsl 

Example A-9 shows the content of the 

Process I nventoryReqmt_UpdateInventoryReservationsReq.xsl file. 

Example A-9 ProcesslnventoryReqmt_UpdatelnventoryReservationsReq.xsl 
<?xml version="1.0" encoding="UTF-8"?> 

<xsl : stylesheet xml ns :xsl ="http://www. w3.org/1999/XSL/Transform" 

xml ns :xsd= "http://www.w3.org/2001/XMLSchema" 

xml ns :xsi = "http: //www. w3.org/2001/XMLSchema- instance" 

xml ns:xalan="http://xml .apache.org/xalan" 

xml ns :datetime=" http://exslt.org/dates-and-times" 

xml ns :oa=" http: //www. openappl i cations.org/oagi s/9" 

xml ns : udt= "http: //www. openappl i cations.org/oagi s/9/unqual i f i eddatatypes 

/ 1 . 1 " xml ns :_wcf=" http: //www. ibm.com/xml ns/prod/commerce/9/foundation" 

xml ns :_sto=" http: //www. ibm.com/xml ns/prod/commerce/9/store" 

xml ns :_i nv="http : //www. i bm. com/xml ns/prod/commerce/9/i nventory" 

xml ns :_ord=" http: //www. ibm.com/xml ns/prod/commerce/9/order" 

xml ns:test="http://test" excl ude-resul t-prefixes="xal an oa udt _wcf 

_sto _inv _ord" version="1.0"> 

<xsl :output method="xml " encodi ng="UTF-8" indent="yes" 
xalan:indent-amount="2" /> 

<xsl :strip-space elements="*" /> 

<xsl template match="/"> 

<xsl variable name="order" 

sel ect="_i nv : Process I nventoryRequi rement/_i nv : DataArea/_i nv : InventoryRe 
quirement" /> 

<test : updatelnventoryReservati ons> 

<order> 

<orderId><xsl :value-of 

select="$order/_ord:OrderIdentifier/_wcf : Uni quel D" /></orderId> 
<description xsi :ni 1 ="true" /> 

<storeId><xsl :value-of 

select="$order/_ord:StoreIdentifier/_wcf : Uni quel D" /></storeId> 
<userDn><xsl :value-of 

sel ect="$order/_ord : Buyer Identi f i er/_wcf : Di sti ngui shedName" /></userDn> 
<status><xsl :value-of 

sel ect="$order/_ord:OrderStatus/_ord: Status" /></status> 

<xsl :choose> 

<xsl :when test="$order/_ord:PlacedDate"> 
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<submissionDate><xsl :value-of 
sel ect="$order/_ord : PI acedDate" /></submi ssi onDate> 

</xsl :when> 

<xsl :otherwise> 

<submissionDate xsi :nil="true" /> 

</xsl :otherwise> 

</xsl :choose> 

<orderItems> 

<xsl :for-each select="$order/_ord:0rderltem"> 

<OrderItem> 

<orderItemId><xsl : val ue-of 

select="_ord:0rderltemldentifier/_wcf :UniqueID" /></orderItemId> 
<sku><xsl :val ue-of 

sel ect="_ord :Catal ogEntryldenti fier/_wcf: External Identi fi er/_wcf : PartNu 
mber" /></sku> 

<quantity> 

<value><xsl :value-of select="_ord:Quantity" 

/></val ue> 

<xsl :choose> 

<xsl :when test="_ord:Quantity/@uom"> 

<uom><xsl :val ue-of 
sel ect="_ord : Quant ity/@uom" /></uom> 

</xsl :when> 

<xsl :otherwise> 

<uom>C62</uom> 

</xsl :otherwise> 

</xsl :choose> 

</quantity> 

<shippingModeId><xsl : val ue-of 

sel ect="_ord :OrderItemShi ppi ngInfo/_ord:Shi ppi ngMode/_ord : Shi ppi ngModel 
denti f i er/_ord : External Identi f i er/_ord : Shi pModeCode" 

/></shi ppi ngModeId> 

<ful fi 1 lmentCenterId><xsl : val ue-of 

sel ect="_ord : Ful f i 1 1 mentCenter/_ord : Ful f i 1 1 mentCenter Identi f i er/_wcf : Na 
me" /></fulfillmentCenterId> 

<xsl :choose> 

<xsl :when 

test="_ord :OrderItemShi ppi ngInfo/_ord : RequestedShi pDate"> 
<requestedShipDate><xsl :val ue-of 
sel ect= "_ord: Order I temShi ppi ng I nfo/_ord: RequestedShi pDate" 
/></requestedShi pDate> 

</xsl :when> 

<xsl :otherwise> 

<requestedShi pDate xsi :ni 1 ="true" /> 

</xsl :otherwise> 
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</xsl :choose> 

<status><xsl :value-of 

sel ect= "_ord : Order I temStatus/_ord : Status " /></status> 

<inventoryStatus xsi :ni 1 ="true" /> 

<availableDate xsi :nil="true" /> 

<shipDate xsi :ni 1 ="true" /> 

<attribute> 

<!-- temporary --> 

<Attribute> 

<name>wcFul f i 1 lmentCenterId</name> 

<val ue><xsl : val ue-of 

sel ect="_ord : Ful fi 1 lmentCenter/_ord : Ful f i 1 ImentCenterldenti f i er/_wcf : Un 
iquelD" /></value> 

</Attribute> 

</attribute> 

</OrderItem> 

</xsl :for-each> 

</orderItems> 

</order> 

</test : updatelnventoryReservati ons> 

</xsl : tempi ate> 

</xsl :stylesheet> 
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A.1 0 UpdatelnventoryReservationsResp_ 
AcknowledgelnventoryReqmt.xsl 

Example A-1 0 shows the contents of the 

UpdateInventoryReservationsResp_AcknowledgeInventoryReqmt.xsl file. 
Example A-10 UpdatelnventoryReservationsResp_AcknowledgelnventoryReqmt.xsl 
<?xml version="1.0" encoding="UTF-8"?> 

<xsl : stylesheet xml ns :xsl ="http://www. w3.org/1999/XSL/Transform" 

xml ns :xsd= "http://www.w3.org/2001/XMLSchema" 

xml ns :xsi = "http: //www. w3.org/2001/XMLSchema- instance" 

xml ns:xalan="http://xml .apache.org/xalan" 

xml ns :datetime=" http://exslt.org/dates-and-times" 

xml ns :oa=" http: //www. openappl i cations.org/oagi s/9" 

xml ns : udt= "http: //www. openappl i cations.org/oagi s/9/unqual i f i eddatatypes 

/ 1 . 1 " xml ns :_wcf=" http: //www. ibm.com/xml ns/prod/commerce/9/foundation" 

xml ns :_sto=" http: //www. ibm.com/xml ns/prod/commerce/9/store" 

xml ns :_i nv="http : //www. i bm. com/xml ns/prod/commerce/9/i nventory" 

xml ns :_ord=" http: //www. ibm.com/xml ns/prod/commerce/9/order" 

xml ns :test=" http: //test" excl ude-resul t-prefixes="xal an test" 

version="1.0"> 

<xsl :output method="xml " encodi ng="UTF-8" indent="yes" 
xalan:indent-amount="2" /> 

<xsl :strip-space elements="*" /> 

<xsl template match="/"> 

<xsl variable name="order" 

select="test:updateInventoryReservationsResponse/updateInventoryReserva 
tionsReturn" /> 

<_i nv : Acknowl edgelnventoryRequi rement> 

<oa:Appl icationArea> 

<oa : Creat i onDateT i me 

xsi :type="udt:DateTimeType"><xsl :val ue-of select="datetime:dateTime() " 
/></oa:CreationDateTime> 

</oa:Appl icationArea> 

<_inv:DataArea> 

<oa:Acknowledge /> 

<_i nv : InventoryRequi rement> 

<_ord :0rderldenti f i er> 

<_wcf : Uni quel D><xsl :value-of sel ect="$order/orderId" 
/></_wcf : Uni queID> 

</_ord :0rderldenti f i er> 

<xsl :for-each sel ect="$order/orderltems/0rderltem"> 
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<_ord:0rderltem> 

<_ord:0rderltemldentifier> 

<_wcf : Uni quel D><xs 1 :value-of 
select="orderItemId" /></_wcf : Uni queID> 

</_ord :OrderI temldenti f i er> 
<_ord:OrderItemStatus> 

<_ord:Status><xsl :value-of sel ect="status" 

/></_ord:Status> 

<xsl :choose> 

<xsl :when test="inventoryStatus= 1 A 1 "> 

<_ord : InventoryStatus>Al 1 ocated</_ord : InventoryStatus> 
</xsl :when> 

<xsl :when test="inventoryStatus= 1 B'"> 

<_ord:InventoryStatus>Backordered</_ord: InventoryStatus> 

</xsl :when> 

<xsl :otherwise> 

<_ord:InventoryStatus>Unal 1 ocated</_ord: InventoryStatus> 

</xsl :otherwise> 

</xsl :choose> 

</_ord:OrderItemStatus> 

<_ord:OrderItemFul fi 1 lmentInfo> 

<xsl :if 

test="availableDate[not(@xsi : ni 1 = 1 true ' )] "> 

<_ord : Avai 1 abl eDate><xsl : val ue-of 
sel ect="avai 1 abl eDate" /></_ord : Avai 1 abl eDate> 

</xsl :if> 

<xsl :if test="shipDate[not(@xsi : ni 1 = 1 true ' )] "> 
<_ord:ExpectedShipDate><xsl :val ue-of 
sel ect="shi pDate" /></_ord : ExpectedShi pDate> 

</xsl :if> 

</_ord :OrderItemFul f i 1 1 merit Inf o> 

<xsl : i f 

test="ful fil lmentCenterId[not(@xsi :ni 1 = ' true')] "> 

<_ord : Ful f i 1 1 mentCenter> 

<_ord : Ful f i 1 1 mentCenterldenti f i er> 

<!-- temporary --> 

<_wcf :UniqueID><xsl :val ue-of 

sel ect="attri bute/Attribute[name= ' wcFul f i 1 ImentCenterld '] /val ue" 
/></_wcf : Uni quel D> 

<_wcf :Name><xsl : val ue-of 
select="ful fi 1 ImentCenterld" /></_wcf :Name> 

</_ord : Ful f i 1 1 mentCenterldenti f i er> 

</_ord : Ful f i 1 1 mentCenter> 
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</xsl :if> 
</_ord:OrderItem> 

</xsl :for-each> 

</_i nv : InventoryRequi rement> 
</_inv:DataArea> 

</_inv:AcknowledgeInventoryRequirement> 
</xsl : tempi ate> 

</xsl :stylesheet> 


Building Multichannel Applications with WebSphere Commerce 



B 


Sample code 


This appendix includes various sample codes that you can use with the 
examples Chapter 5, “Mobile commerce features in WebSphere Commerce V7” 
on page 177. 


© Copyright IBM Corp. 2010. All rights reserved. 
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B.1 ReviewsDataBean sample code 

Example B-1 shows the content of the ReviewsDataBean sample code. 

Example B-1 ReviewsDataBean Sample code 
package com. i bm . i tso . commerce . soccom . beans ; 

import java. util .LinkedHashMap; 
import java. util .LinkedList; 
import java. util .List; 
import java. util .logging. Level ; 
import java. util .logging. Logger; 

import org. apache. commons. httpcl ient.HttpCl ient; 
import org .apache. commons . httpcl i ent . NameVal uePai r; 
import org .apache. commons . httpcl i ent .methods .GetMethod ; 
import org. apache. commons. httpclient. util . Encodi ngllti 1 ; 
import org.json. JSONArray; 
import org.json. JSONObject; 

import com . i bm . commerce . beans . SmartDataBean ; 
import com. ibm. commerce. beans. SmartDataBean Impl ; 

public class ReviewsDataBean extends SmartDataBeanlmpl implements 
SmartDataBean { 

private static final int INT_N0_SET = -1; 

//pageSize sets the number of reviews to be displayed on a page 
private int pageSize = INT_N0_SET; 

//onPage sets the page number 
private int onPage = INT_N0_SET; 

//sortOptions sets the sort type & sort direction of the results. 
//Its format is sort type | sort direction. Valid values for sort type 
are “rating” and “submissionTime". Valid values for sort direction are 
“asc” & “desc“. 

private String sortOptions; 

//partNumber sets the Part number for which results are needed, 
private String partNumber; 

//numOfOveral 1 Ratings - total number of ratings for the product, 
private int numOfOveral 1 Ratings; 

//this is average overall rating for the product, 
private double avgOveral 1 Rating; 
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//Lower bound used to calculate the average rating, 
private int lowerBound; 

//Upper bound used to calculate the average rating 
private int upperBound; 

//Sorted map of reviewld and ReviewDetai 1 Bean 
private LinkedHashMap<String, ReviewDetai 1 Bean> reviewDetai 1 sMap; 
//Sort direction used for sorting 
private String sortDirection; 

//Number of results returned by sMash application, to be displayed 
on a page. - used in Pagination 
private int noOfEntriesPerPage; 

//Total number of reviews for the product - used in Pagination 
private int noOfTotal Entries; 

//Current page number - used in pagination 
private int pageNum; 

//Sort type used for sorting 
private String sortType; 

//Number of total pages - Used in pagination 
private int noOfTotal Pages; 

private String errorMessage = null; 
private Throwable errorException = null; 

private static final String CLASS_NAME = 

Revi ewsDataBean . cl ass .getName () ; 

private static final Logger LOGGER = Logger. getLogger(CLASS_NAME) ; 
public ReviewsDataBean() { 

reviewDetailsMap = new LinkedHashMap<String, ReviewDetai 1 Bean>() ; 

} 

private void setErrorState(String error, Throwable t) { 
errorMessage = error; 
errorException = t; 

} 

public boolean isErrorQ { 
return errorMessage != null; 

} 

public String getErrorMessageQ { 
return errorMessage; 

} 

public Throwable getErrorExceptionQ { 
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return errorException; 


} 

public int getNumOfOveral 1 Rati ngs() { 
return numOfOveral 1 Rati ngs; 

} 

public double getAvgOveral 1 Rati ng() { 
return avgOveral 1 Rating; 

} 

public int getLowerBoundQ { 
return lowerBound; 

} 

public int getUpperBoundQ { 
return upperBound; 

} 

public void setPageSize(int pageSize) { 
this.pageSize = pageSize; 

} 

public void setOnPage(i nt onPage) { 
this.onPage = onPage; 

} 

public void setSortOptions (String sortOptions) { 
this.sortOptions = sortOptions; 

} 

public void setPartNumber(Stri ng partNumber) { 
this.partNumber = partNumber; 

} 

public LinkedHashMap<String, ReviewDetai 1 Bean> getReviewDetailsMapQ 
return reviewDetai 1 sMap; 

} 

public String getSortDirectionQ { 
return sortDirection; 

} 

public int getNoOfEntriesPerPageQ { 
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return noOfEntriesPerPage; 


public int getNoOfTotal Entries () { 
return noOfTotal Entries; 

} 

public int getPageNumQ { 
return pageNum; 

} 

public String getSortType() { 
return sortType; 

} 

public int getNoOfTotal Pages() { 
return noOfTotal Pages; 

} 

public void populate() { 

final String METHOD_NAME = "populate"; 

LOGGER. entering (CLASSJAME, METHOD_NAME) ; 
errorMessage = null; 
errorException = null; 

String rating = 
try { 

if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. 1 ogp(Level . FINE, CLASSJAME, METHOD_NAME, "partNumber : 
\"{0}\", pageSize: \"{1}\", onPage: \"{2}\", sortOptions: \"{3}\"",new 
String[] { partNumber, String. valueOf (pageSize) , 

String.val ueOf (onPage) .sortOptions }) ; 

} 

if (partNumber != null) { 

//Read protocol and host name from properties 
String urlString = http://localhost/soccom/api/items/"+ 
partNumber + "/reviews"; 

if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. logp(Level .FINE, CLASSJAME, METHOD JAME, "URL: 
\"{0}\"", urlString); 

} 

HttpClient client = new HttpCl ient() ; 
cl ient.getParams() .setParameter(" http. socket. timeout", 

2000 ) ; 
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cl i ent . getParams () . setParameter ( "http . protocol . content-charset" , 
"utf-8") ; 


// Create a method instance. 

GetMethod method = new GetMethod(url String) ; 

List<NameValuePair> params = new 
LinkedList<NameVal uePair>() ; 

if (pageSize != INT_N0_SET) { 

params . add (new NameVal uePai r ( "pageSi ze" , 

String.val ueOf (pageSize))) ; 

} 

if (onPage != INT_N0_SET) { 

params . add (new NameVal uePai r ( "onPage" , 

String.val ueOf (onPage))) ; 

} 

params. add (new NameValuePair("sortOptions", sortOptions)) 

NameVal uePai r[] nvpArr = params .toArray( new 
NameVal uePai r [params .si ze ()] ) ; 

method . setQueryStri ng (Encodi ngUti 1 . formUrl Encode (nvpArr , 

"utf-8")); 

method.getParamsO .setParameter ("http. socket. timeout", 

2000 ); 


// Execute 

int statuscode = cl ient.executeMethod(method) ; 

if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. logp(Level. FINE, CLASS_NAME, METH0D_NAME, 
"HTTP status code: {0}", statuscode); 

} 

if (statuscode >= 200 && statuscode < 400) { 

// Read the response body. 

byte[] responseBody = method. getResponseBody () ; 

rating = new String(responseBody, "UTF-8"); 

if (LOGGER. isLoggable(Level .FINE)) { 

LOGGER. logp(Level. FINE, CLASS_NAME, METH0D_NAME, 
"HTTP response: \"{0}\"", rating); 
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method. releaseConnection() ; 

} 

} catch (Exception e) { 

LOGGER. logp(Level. SEVERE, CLASS_NAME, METHODJAME, 

"Exception in trying to retrieve review details", e) ; 
setErrorState(" Exception in trying to retrieve review 
details", e); 

} 

try { 

if (rating != null && !rating.equals("")) { 

JSONObject json = new JSONObject (rating) ; 
if (json.getInt("status") == 200) { 

JSONObject data = json.getJS0N0bject("data") ; 

JSONObject ratingStatistics = 
data . get JSONObj ect ( " rati ngStat i sties"); 

numOfOverall Ratings = 

rati ngStat i sties. get Int("numOfOveral 1 Ratings") ; 

if (numOfOverall Ratings > 0) { 
avgOverall Rating = 

rati ngStat i st i cs .getDoubl e("avgOveral 1 Rati ng") ; 

} 

JSONObject ratingRange = 
rat i ngStat i sties. get JSONObj ect (" rat i ngRange" ) ; 

upperBound = ratingRange. getInt("upperBound") ; 
lowerBound = ratingRange. getInt("lowerBound") ; 

JSONObject paginationDetails = 
data.getJSONObject("paginationDetai Is"); 
sortDirection = 

paginationDetai 1 s.getStri ng(" sortDirection") ; 
noOfEntriesPerPage = 

paginationDetai 1 s.getInt("noOfEntriesPerPage") ; 
noOfTotal Entries = 

paginationDetai 1 s. get Int( "noOfTotal Entries") ; 

pageNum = paginationDetails. getInt("pageNum") ; 
sortType = paginationDetails. getString("sortType") ; 
noOfTotal Pages = 

paginationDetai 1 s. get Int( "noOfTotal Pages") ; 

JSONArray reviews = data.getJSONArray("reviews") ; 
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if (reviews. length() > 0) { 

JSONObject review = null; 

ReviewDetailBean reviewDetails = null; 
for (int i = 0; i < reviews. length() ; i++) { 
review = reviews. getJSONObject(i) ; 
reviewDetails = new ReviewDetai 1 Bean() ; 

reviewDetails.setRatingOnly(review.getBoolean("isRatingOnly")); 

reviewDetail s.setItemId(review.getString("i temld")) ; 

revi ewDetai 1 s . setRati ng (revi ew. get Int ( "rating")) ; 
int reviewld = review. getlnt("reviewld") ; 
revi ewDetai 1 s . setRevi ewld (revi ewld) ; 

reviewDetail s.setRevi ewText (review. getString ("revi ewText")) ; 

reviewDetail s.setSubmissi onTime (revi ew.getString( "submiss ionTime")) ; 

reviewDetail s.setTitle(revi ew. getString ("title") ) ; 

reviewDetail s.setUserld (review. getString ("userid") ) ; 

reviewDetail sMap. put (String.val ueOf (reviewld) , 

reviewDetails); 


} 

} 

} 

} 

} catch (Exception e) { 

LOGGER. logp(Level. SEVERE, CLASS_NAME, METHODJAME, "Exception 
in trying to parse review details", e) ; 

setErrorState(" Exception in trying to parse review details", 
e); 

} 

} 

} 
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B.2 ReviewsDetailBean sample code 


Example B-2 shows the content of the ReviewsDetailBean sample code. 
Example B-2 ReviewDetailBean Sample code 
package com. i bm . i tso . commerce . soccom . beans ; 

import java. text. ParseException; 
import java. uti 1 .Date; 

public class ReviewDetailBean { 
private boolean isRatingOnly; 
private int reviewld; 
private String reviewText; 
private String userid; 
private String title; 
private String submissionTime; 
private int rating; 
private String itemld; 
private String toStringCache = null; 

public boolean isRatingOnly() { 
return isRatingOnly; 

} 

public void setRati ngOnly (bool ean isRatingOnly) { 
this. isRatingOnly = isRatingOnly; 
toStringCache = null; 

} 

public int getReviewId() { 
return reviewld; 

} 

public void setReviewId(int reviewld) { 
this. reviewld = reviewld; 
toStringCache = null; 

} 

public String getReviewText() { 
return reviewText; 

} 

public void setReviewText (String reviewText) { 
this. reviewText = reviewText; 
toStringCache = null; 

} 

public String getUserId() { 
return userid; 
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public void setUserId(String userid) { 
this. userid = userid; 
toStringCache = null; 

} 

public String getTitleQ { 
return title; 

} 

public void setTitle(String title) { 
this. title = title; 
toStringCache = null; 

} 

public String getSubmissionTime() { 
return submissionTime; 

} 

public Date getSubmissionTimeAsDate() 

{ 

java. text. SimpleDateFormat sdf = new 
java. text. Si mpleDateFormat("yyyy-MM-dd 1 T 1 hh:mm:ss.SSS") ; 

try { 

java. uti 1 .Date d = sdf.parse(getSubmissionTime()) ; 
return d; 

} catch (ParseException e) { 
return nul 1 ; 


public void setSubmissionTime(String submissionTime) { 
this. submissionTime = submissionTime; 
toStringCache = null; 

} 

public int getRating() { 
return rating; 

} 

public void setRating(int rating) { 
this. rating = rating; 
toStringCache = null; 

} 

public String getltemld() { 
return itemld; 

} 

public void setItemId(String itemld) { 
this. itemld = itemld; 
toStringCache = null; 

} 
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public String toString() { 
if (toStringCache == null) { 

StringBuffer buf = new Stri ngBuffer() ; 

buf .append("{") ; 

buf .append("reviewld: "); 

buf .append(reviewld) ; 

buf .append(", itemld: "); 

buf .append(itemld) ; 

buf .append(", userid: "); 

buf .append(userld) ; 

buf .append(", submissionTime: "); 

buf .append(submissionTime) ; 

buf .append(", rating: "); 

buf .append(rating) ; 

buf .append(", title: "); 

buf.append(title); 

buf .append(", reviewText: "); 

buf .append(reviewText) ; 

buf .append("} ") ; 

toStringCache = buf .toString() ; 

} 

return toStringCache; 


} 
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B.3 ReviewsDataBean sample code 


Example B-3 shows the content of the ProductReviewList.jsp sample code. 
Example B-3 Sample code for ProductReviewList.jsp 


***** 

* This JSP displays the product review list. It lets user sort the 
reviews based on rating or submission time. 

* It also has Pagination capabilities built in it. 

***** 


<!-- BEGIN ProductReviewList.jsp --> 


<%@ taglib uri="http://java. sun.com/jsp/jstl/fmt" prefix="fmt" %> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/functions" prefix="fn" %> 
<%@ taglib uri="http://java. sun.com/jsp/jstl/core" prefix="c" %> 

<%@ taglib uri="http://commerce. ibm.com/base" prefix="wcbase" %> 

<%@ taglib uri="http://commerce. ibm.com/foundation" prefix="wcf" %> 

<%@ include fi 1 e=" ../../../. ./incl ude/parameters .jspf" %> 

<%@ include fi 1 e=" ../../. ./incl ude/JSTLEnvi ronmentSetup. jspf " %> 


<c:set var="productId" value="${WCParam.productId}" /> 
<c:set var="pgGrp" value="${WCParam.pgGrp}" /> 


<wcbase:useBean id="catal ogEntry" 

cl assname="com. i bm. commerce . catal og . beans . Catal ogEntryDataBean" /> 
<c:choose> 

<c:when test="${catal ogEntry. bundle == true}"> 

<wcbase:useBean id="product" 

cl assname="com. i bm. commerce . catal og . beans . Bundl eDataBean" 
scope="request" /> 

</c:when> 

<c:when test="${catal ogEntry. package == true}"> 

<wcbase:useBean id="product" 

cl assname="com. i bm. commerce. catal og . beans . PackageDataBean" 
scope="request" /> 

</c:when> 
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<c:when test="${catalogEntry.item == true}"> 

<wcbase:useBean id="product" 

classname="com.ibm. commerce. catalog. beans. ItemDataBean" scope=" request" 
/> 

</c:when> 

<c:when test="${catal ogEntry. product == true}"> 

<wcbase:useBean id="product" 

cl assname="com. i bm. commerce . catal og . beans . ProductDataBean" 
scope="request" /> 

</c:when> 

</c:choose> 

<c:set property="partNumber" val ue="$ {catal ogEntry. partNumber}" 
target="${WCParam} "/> 

<c:set var="productPage" value="true" scope="request"/> 


<wcbase:useBean id="reviews" 

classname="com.ibm.i tso. commerce. soccom. beans. ReviewsDataBean"> 

<c:set property="pageSize" value="5" target="${reviews} "/> 

<c:set property="onPage" val ue="${WCParam.onPage} " 
target="${reviews} "/> 

<c : set property="sortOpti ons" val ue="$ {WCParam. sortOpti ons } " 
target="${reviews} "/> 

<c:set property="partNumber" val ue="${WCParam. partNumber} " 
target="${reviews} "/> 

</wcbase:useBean> 

<! DOCTYPE html PUBLIC "-//WAPFORUM//DTD XHTML Mobile 1.2//EN" 

" http: //www. openmobi leal liance.org/tech/DTD/xhtml -mobi lel2.dtd"> 

<html xml ns=" http: //www. w3.org/ 1999/xhtml " 1 ang="${shortLocal e} " 
xml :lang="${shortLocale}"> 

<head> 

<title><fmt:message key="PRODUCT_TITLE" bundl e="${storeText} " />: 
<c:out val ue="${ catal ogEntry. description. name} " 
escapeXml ="fal se"/></ti tl e> 

<meta http-equi v="content-type" content="appl i cat ion/xhtml +xml " 

/> 

<meta http-equi v="cache-control " content="max-age=300" /> 

<meta name="viewport" content="width=device-width, 
initial-scale=1.0, user-scalable=no" /> 

<1 i nk rel="stylesheet" href="${cssPath}"/> 

</head> 

<body> 

<div id="wrapper"> 
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<%@ include fi 1 e=" ./incl ude/HeaderDi spl ay .jspf" %> 

<%@ include 

file=". ./. ./. ./include/BreadCrumbTrailDisplay.jspf"%> 

<%out.fl ush() ;%> 

<div id="reviews" cl ass="content_box"> 

<di v class="heading_container"> 

<h2>Reviews</h2> 

<di v cl ass="cl ear_f 1 oat"></di v> 

</di v> 

<c:choose> 

<c : when test= "$ { reviews . error} "> 

<1 i><fmt:message key="RATING_OVERALL_ERROR" 
bundle="${storeText}" /></li> 

</c:when> 

<c:otherwise> 

<a href="javascript:void(0) ;"><c:out 
val ue="${ product. descript ion. name} " escapeXml ="fal se"/></a> 

<p>0verall Rating: 

<c: import 

url = M ${jspStoreDir}mobi le/Snippets/ReusableObjects/StarRating.jsp"> 
<c:param name="l owerBound" 
val ue= "$ { reviews . 1 owerBound } " /> 

<c:param name="upperBound" 
val ue= "$ { reviews . upperBound } " /> 

<c:param name="avgOveral 1 Rating" 
val ue="${reviews.avgOveral 1 Rating} " /> 

</c:import> 

</p> 

<c:choose> 

<c:when test="${userType eq ' G 1 } "> 

<wcf:url var="logOnURL" val ue="Mobi 1 eLogonForm"> 
<wcf:param name="catalogId" 
val ue="${WCParam.catalogId} " /> 

<wcf:param name="storeId" 
val ue="${WCParam.storeId} " /> 

<wcf:param name="l angld" val ue="${WCParam. 1 angld} " 

/> 

</wcf :url> 

<wcf:url var="registerURL" 
val ue="Mobi 1 ellserRegi strati onAddForm"> 

<wcf:param name="catalogId" 
val ue="${WCParam.catalog!d} " /> 
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<wcf:param name="storeId" 
val ue="${WCParam.storeId} " /> 

<wcf:param name="l angld" val ue="${WCParam. 1 angld} " 

/> 

<wcf:param name="regi ster_button" val ue="Register" 

/> 

</wcf :url> 

<a href="${fn:escapeXml (registerURL)}">Register</a> 
to create a new review or <a href="${fn:escapeXml ( 1 ogOnURL) } " 
title="<fmt:message key="SIGN_IN" bundle="${storeText} " 

/>"><fmt:message key="SIGN_IN" bundl e="${storeText} " /></ a> in if you 
are already a member. 

</c:when> 

<c:otherwise> 

<form method="get" action="mPostReviewsView"> 

<fieldset> 

<c:forEach var="parameter" 
items="${WCParamVal ues} "> 

<c:forEach var="value" 
i tems= "$ { parameter . val ue} "> 

<input type="hidden" name="${parameter.key} " 

val ue="${val ue} " /> 

</c:forEach> 

</c:forEach> 

<input type="hidden" name="partNumber" 
val ue="${WCParam.partNumber}" /> 

<input type="submit" name="review" value="Write a 

review" /> 

</fieldset> 

</form> 

</c:otherwise> 

</c:choose> 

<div class="sort_by_control "> 

Sort by: 

<c:choose> 

<c:when test="${reviews.sortType == 'rating' || 
reviews. sortType == 'default' }"> 

<wcf :url var="ProductReviewListSortURL" 
val ue="mProductReviewsView"> 

<wcf:param name="l angld" val ue="${l angld} " /> 
<wcf:param name="storeId" 
val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" 
val ue="${WCParam.catalog!d} " /> 
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<wcf:param name="productId" 
val ue="${WCParam.productId} " /> 

<wcf:param name="pgGrp" 
val ue="${WCParam.pgGrp} " /> 

<wcf:param name="onPage" 
val ue="${WCParam.onPage} " /> 

<wcf:param name="sortOptions" 
val ue="submissionTime|desc" /> 

</wcf :url> 

<span class="current_sort">Highest rating</span> 
<a href="<c:out value="${ProductReviewListSortURL}"/ > " > Newest post</a> 
</c:when> 

<c:otherwise> 

<wcf : url var="ProductRevi ewLi stSortURL" 
val ue="mProductReviewsView"> 

<wcf:param name="l angld" val ue="${l angld} " /> 
<wcf:param name="storeId" 
val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" 
val ue="${WCParam.catalogId} " /> 

<wcf:param name="productId" 
val ue="${WCParam.productId} " /> 

<wcf:param name="pgGrp" 
val ue="${WCParam.pgGrp} " /> 

<wcf:param name="onPage" 
val ue="${WCParam.onPage} " /> 

<wcf:param name="sortOptions" 

value="rating|desc" /> 

</wcf :url> 

<a href="<c:out 

val ue="$ { ProductRevi ewLi stSortURL} "/>">Hi ghest 

rating</a>&nbsp;&nbsp;<span cl ass="current_sort">Newest post</span> 
</c:otherwise> 

</c:choose> 

</di v> 

<ol class="l ist_reviews"> 

<c:forEach var="reviewDet" 

items="${reviews.reviewDetail sMap} " varStatus=" status "> 

<wcf:url var="readReviewLink" value="mReviewDetails"> 
<c:forEach var="parameter" items="${WCParamVal ues} "> 
<c:forEach var="value" items="${parameter.value}"> 
<wcf :param name="${ parameter. key} " 

val ue="${val ue} " /> 

</c:forEach> 
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</c:forEach> 

<wcf:param name="reviewld" 
val ue="${reviewDet.value.reviewId} "/» 

</wcf :url> 

<li> 

<div class="container"> 

<a href="#" class="user_image"><img src="<c:out 
val ue="${jspStoreImgDir} "/>images/avatar. jpg" width="34" height="34" 
al t="<c:out val ue="${ product. descript ion. name} " escapeXml ="fal se"/>" 
/></ a> 

<ul> 

<1 i><c: import 

url ="${ jspStoreDi rjmobi 1 e/Sni ppets/Reusabl eObjects/StarRati ng . jsp"> 
<c:param name="l owerBound" 
val ue="${revi ews . 1 owerBound} " /> 

<c:param name="upperBound" 
val ue="${reviews.upperBound}" /> 

<c : param name= "avgOveral 1 Rati ng " 
val ue="$ {reviewDet. value. rati ng } " /> 

</c:import></l i> 

<1 i><h4><c:out 

val ue="${ reviewDet. val ue. title} " escapeXml ="fal se"/></h4></l i> 

<li>by: <c:out 

val ue="${reviewDet. val ue. userid} " escapeXml ="fal se"/> on 

<fmt:formatDate pattern="M/d/yy h:mma" 

val ue="${ reviewDet. val ue.submissionTimeAsDate} " /></l i> 

<li><span class="bul let">&#187; </span><a 
href="${readReviewLink}">Read review</a></l i> 

</ul> 

<di v class="clear_float"></di v> 

</di v> 

</l i> 

</c:forEach> 

</ol> 


<div class="paging_control "> 

<wcf :url var="ProductReviewListPrevURL" 
val ue="mProductReviewsView"> 

<wcf:param name="langld" val ue="${l angld} " /> 
<wcf: param name="storeId" 
val ue="${WCParam.storeId} " /> 

<wcf: param name="catal ogld" 
val ue= "${WCParam. catalog Id } " /> 

<wcf: param name="productId" 
val ue="${WCParam.productId} " /> 
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<wcf:param name="pgGrp" val ue="${WCParam.pgGrp} " /> 
<wcf:param name="onPage" value="${reviews.pageNum - 

1 }" /> 

<wcf:param name="sortOptions" 
val ue="${WCParam.sortOptions} "/> 

</wcf :url> 

<wcf :url var="ProductReviewListNextURL" 
val ue="mProductReviewsView"> 

<wcf:param name="l angld" val ue="${l angld} " /> 
<wcf:param name="storeId" 
val ue="${WCParam.storeId} " /> 

<wcf:param name="catalogId" 
val ue="${WCParam.catalogId} " /> 

<wcf:param name="productId" 
val ue="${WCParam.productId} " /> 

<wcf:param name="pgGrp" val ue="${WCParam.pgGrp} " /> 
<wcf:param name="onPage" value="${reviews.pageNum + 

1 }" /> 

<wcf:param name="sortOptions" 
val ue="${WCParam.sortOptions} "/> 

</wcf :url> 

<div class="page_number">Page <c:out 
val ue="${reviews.pageNum} " escapeXml ="fal se"/>/<c:out 
val ue="${reviews.noOf Total Pages} " escapeXml ="fal se"/></di v> 

<c:if test="${reviews.noOfTotal Pages > 1}"> 

<c:if test="${reviews.pageNum > 1}"> 

<span class="bul let">&#171; </span> 

<a href="<c:out 

val ue="$ { ProductRevi ewLi stPrevURL} "/>" t i tl e=" Previ ous Page">Prev</a> 
</c : i f > 

<c:if test="${reviews.pageNum < 
reviews. noOfTotal Pages} "> 

&nbsp;&nbsp;<a href="<c:out 

val ue="${ ProductRevi ewLi stNextURL} "/>" title="Next Page">Next</a><span 
class="bul let"> &#187;</span> 

</c : i f > 

</c:if> 

</di v> 

</c:otherwise> 

</c:choose> 

</di v> 

<%out.fl ush() ;%> 

<%@ include fi 1 e=" ./incl ude/FooterDi spl ay .jspf" %> 

</di v> 
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</body> 

</html> 


B.4 PostReview sample code 

Example B-4 shows the content of the PostReview. jsp sample code. 
Example B-4 Sample code for PostReview.jsp 

Licensed Materials - Property of IBM 
WebSphere Commerce 

(C) Copyright IBM Corp. 2008, 2009 All Rights Reserved. 

US Government Users Restricted Rights - Use, duplication or 
disclosure restricted by GSA ADP Schedule Contract with 
IBM Corp. 

— %> 



* This JSP takes the review inputs and submits to PostReviewCmd. 

— %> 

<!-- BEGIN PostReview.jsp --> 


<%@ taglib uri="http://java. sun.com/jsp/jstl/fmt" prefix="fmt" %> 

<%@ taglib uri="http://java. sun.com/jsp/jstl/functions" prefix="fn" %> 
<%@ taglib uri="http://java. sun.com/jsp/jstl/core" prefix="c" %> 

<%@ taglib uri="http://commerce. ibm.com/base" prefix="wcbase" %> 

<%@ taglib uri="http://commerce. ibm.com/foundation" prefix="wcf" %> 

<%@ include fi 1 e=" ../../../. ./incl ude/parameters .jspf" %> 

<%@ include fi 1 e=" ../../. ./incl ude/JSTLEnvi ronmentSetup. jspf " %> 

<%@ include fi 1 e=" ../../. ./incl ude/ErrorMessageSetup. jspf " %> 
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<c:set var="starImgPath" value="/soccom/ibm/social/images/" /> 

<c:set var="productId" value="${WCParam.productId}" /> 

<c:set var="pgGrp" value="${WCParam.pgGrp}" /> 

<wcbase:useBean id="catal ogEntry" 

cl assname="com. i bm. commerce . catal og . beans . Catal ogEntryDataBean" /> 
<c:choose> 

<c:when test="${catal ogEntry. bundle == true}"> 

<wcbase:useBean id="product" 

cl assname="com. i bm. commerce . catal og . beans . Bundl eDataBean" 
scope="request" /> 

</c:when> 

<c:when test="${catal ogEntry. package == true}"> 

<wcbase:useBean id="product" 

cl assname="com. i bm. commerce . catal og . beans . PackageDataBean" 
scope="request" /> 

</c:when> 

<c:when test="${catalogEntry.item == true}"> 

<wcbase:useBean id="product" 

cl assname= "com. ibm. commerce. catalog. beans. I temDataBean" scope=" request" 
/> 

</c:when> 

<c:when test="${catal ogEntry. product == true}"> 

<wcbase:useBean id="product" 

cl assname="com. i bm. commerce . catal og . beans . ProductDataBean" 
scope="request" /> 

</c:when> 

</c:choose> 

<c:set property="partNumber" val ue="$ {catal ogEntry. partNumber}" 
target="${WCParam} "/> 


<! DOCTYPE html PUBLIC "-//WAPFORUM//DTD XHTML Mobile 1.2//EN" 
"http://www.openmobi leal liance.org/tech/DTD/xhtml -mobi lel2.dtd"> 

<html xml ns=" http: //www. w3.org/ 1999/xhtml " 1 ang="${shortLocal e} " 
xml :lang="${shortLocale}"> 

<head> 

<title><fmt:message key="PRODUCT_TITLE" bundl e="${storeText} " />: 
<c:out val ue="${ product. descript ion. name} " escapeXml ="fal se"/></title> 
<meta http-equi v="content-type" content="appl i cat ion/xhtml +xml " 

/> 

<meta http-equi v="cache-control " content="max-age=300" /> 
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<meta name="viewport" content="width=device-width, 
initial-scale=1.0, user-scalable=no" /> 

<1 i nk rel="stylesheet" href="${cssPath}"/> 

</head> 

<body> 

<div id="wrapper"> 

<%@ include fi 1 e=" ./incl ude/HeaderDi spl ay .jspf" %> 
<%@ include 

file=". ./. ./. ./include/BreadCrumbTrailDisplay.jspf"%> 

<%out.fl ush() ;%> 

<div id="write_review" cl ass="content_box"> 

<di v class="heading_container"> 

<h2>Write a Review</h2> 

<di v cl ass="cl ear_f 1 oat"></di v> 


</di v> 

<a href="javascript:void(0) ;"><c:out 
val ue="${ product. descript ion. name} " escapeXml ="fal se"/></a> 

<p><span class="field_required_symbol ">*</span>Indi cates 
required f i el ds</p> 

<c:choose> 

<c:when test="${ lempty storeError.key && storeError. key 
== '_ERR_USER_NOT_LOGGED_IN ' } "> 

<wcf:url var="logOnURL" val ue="Mobi 1 eLogonForm"> 
<wcf:param name="catalogId" 
val ue="${WCParam.catalogId} " /> 

<wcf:param name="storeId" 
val ue="${WCParam.storeId} " /> 

<wcf:param name="l angld" val ue="${WCParam. 1 angld} " 

/> 

</wcf :url> 

<wcf:url var="registerURL" 
val ue="Mobi 1 ellserRegi strati onAddForm"> 

<wcf:param name="catalogId" 
val ue="${WCParam.catalogId} " /> 

<wcf:param name="storeId" 
val ue="${WCParam.storeId} " /> 

<wcf:param name="l angld" val ue="${WCParam. 1 angld} " 

/> 

<wcf:param name="regi ster_button" val ue="Register" 

/> 
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</wcf :url> 

Review could not be created. <a 

href="${fn:escapeXml (regi sterURL) } ">Regi ster</a> to create a new 
review or <a href="${fn:escapeXml ( 1 ogOnURL) } " title="<fmt:message 
key="SIGN_IN" bundl e="${storeText} " />"><fmt:message key="SIGN_IN" 
bundle="${storeText} " /></ a> in if you are already a member. 

</c:when> 

<c:otherwise> 

<c:choose> 

<c:when test="${ lempty errorMessage} "> 

<p class="error"><c:out val ue="${errorMessage} " 

/></p> 

</c:when> 

<c:otherwise> 

<c:if test="${ lempty storeError. key} "> 

<p class="error"><c:out 
val ue="${storeError. key} " /></p> 

</c : i f > 

</c:otherwise> 

</c:choose> 

<form method="post" action="PostReview"> 

<fieldset> 

<p><span cl ass="f i el d_requi red_symbol ">*</span>Pl ease 
select your rating for this product</p> 

<p class="rating"> 

<input type="radio" name="rati ng" value="l"> 

<img src="${starImgPath}star_ful 1 .10. png" 
width="16" height="13" alt="*" /><img src="${starImgPath}star_grey.png" 

width="16" height="13" alt="-" /><img src="${starImgPath}star_grey.png" 

width="16" height="13" alt="-" /><img src="${starImgPath}star_grey.png" 

width="16" height="13" alt="-" /><img src="${starImgPath}star_grey.png" 

width="16" height="13" alt*"-" /> 

</input><br> 

<input type="radio" name="rati ng" value="2"> 

<img src="${starImgPath}star_ful 1 .10. png" 
width="16" height="13" alt* 1 '*" /><img 

src="${starImgPath}star_ful 1 . 10. png" width="16" height="13" alt="*" 
/><img src="${starImgPath}star_grey.png" width="16" height="13" alt="-" 
/><img src="${starImgPath}star_grey.png" width="16" height="13" alt="-" 
/><img src="${starImgPath}star_grey.png" width="16" height="13" alt="-" 
/> 

</input><br> 

<input type="radio" name="rati ng" value="3"> 

<img src="${starImgPath}star_ful 1 .10. png" 
width="16" height="13" alt="*" /><img 
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src="${starImgPath}star_ful 1 . 10. png" width="16" height="13" alt="*" 
/><img src="${starImgPath}star_ful 1 . 10. png" width="16" height="13" 
alt="*" /><img src="${starImgPath}star_grey.png" width="16" height="13" 
alt="-" /><img src="${starImgPath}star_grey.png" width="16" height="13" 
alt="-" /> 

</input><br> 

<input type="radio" name="rati ng" value="4"> 

<img src="${starImgPath}star_ful 1 .10. png" 
width="16" height="13" alt="*" /><img 

src="${starImgPath}star_ful 1 . 10. png" width="16" height="13" alt="*" 
/><img src="${starImgPath}star_ful 1 . 10. png" width="16" height="13" 
alt="*" /><img src="${starImgPath}star_ful 1 . 10. png" width="16" 
height="13" alt="*" /><img src="${starImgPath}star_grey.png" width="16" 
height="13" alt="-" /> 

</input><br> 

<input type="radio" name="rati ng" value="5"> 

<img src="${starImgPath}star_ful 1 .10. png" 
width="16" height="13" alt="*" /><img 

src="${starImgPath}star_ful 1 . 10. png" width="16" height="13" alt="*" 
/><img src="${starImgPath}star_ful 1 . 10. png" width="16" height="13" 
alt="*" /><img src="${starImgPath}star_ful 1 . 10. png" width="16" 
height="13" alt="*" /><img src="${starImgPath}star_ful 1 .10. png" 
width="16" height="13" alt-"*" /> 

</input> 

</p> 

<div class="input_container"> 

<di v>< 1 abel for="revi ew_ti tl e"><span 
cl ass="f i el d_requi red_symbol ">*</span>Enter a ti tl e</l abel ></di v> 

<input type="text" id="review_title" name="title" 
class="coloured_input" /> 

</di v> 

<di v cl ass="textarea_contai ner"> 

<di v>< 1 abel for="revi ew_comments "><span 
cl ass="f i el d_requi red_symbol ">*</span>Comments</l abel ></di v> 

<textarea id="review_comments" name="body" 
class="coloured_input" rows="8"></textarea> 

</di v> 

<input type="hidden" name="partNumber" 
val ue="${WCParam.partNumber}"/> 

<c:forEach var="parameter" items="${WCParamVal ues} "> 
<c:forEach var="value" items="${parameter.value}"> 
<input type="hidden" name="${parameter.key} " 

val ue="${val ue} "/> 
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</c:forEach> 

</c:forEach> 

<input type="hidden" name="URL" 
val ue="mPostReviewsView"/> 

<input type="hidden" name="viewTaskName" 
val ue="mPostReviewsView"/> 

<input type="hidden" name="errorViewName" 
val ue="mPostReviewsView"/> 

<input type="hidden" name="onPage" value="l"/> 

<input type="hidden" name="sortOptions" 
val ue="submissionTime|desc" /> 

<input type="submit" id="create_review" 
name="create_review" val ue="Create" class="submit" /> <input 
type="button" id="cancel_review" name="cancel_review" val ue="Cancel " /> 
</fieldset> 

</form> 

<p>Content created on this site is subject to a delay in 
viewing due to administrative reasons. </p> 

</c:otherwise> 

</c:choose> 

</di v> 

<%out.fl ush() ;%> 

<%@ include fi 1 e=" ./incl ude/FooterDi spl ay .jspf" %> 

</di v> 

</body> 

</html> 

<!-- END PostReview. jsp --> 
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Additional material 


This book refers to additional material that you can download from the Internet as 
described in this appendix. 


Locating the Web material 

The Web material that is associated with this book is available in softcopy on the 
Internet from the IBM Redbooks Web server. Point your Web browser at: 
ftp : //www. redbooks . i bm.com/redbooks/SG247787 
Alternatively, you can go to the IBM Redbooks Web site at: 
ibm.com/redbooks 

Select the Additional materials and open the directory that corresponds with 
the IBM Redbooks form number, SG247787. 
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Using the Web material 


The additional Web material that accompanies this book includes the following 
files: 

File name Description 

soccom.zip Compressed soccom code samples 

DOMMediationModule-MB.zip Compressed DOM code samples 
Google.zip Compressed store locator samples for Google 

MapQuest.zip Compressed MapQuest code samples 


How to use the Web material 

Create a subdirectory (folder) on your workstation, and decompress the contents 
of the Web material compressed files into this folder. 
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Related publications 


We consider the publications that we list in this section particularly suitable for a 
more detailed discussion of the topics that we cover in this book. 


IBM Redbooks publications 

For information about ordering these publications, see “How to get Redbooks” on 
page 51 1 . Note that some of the documents referenced here might be available 
in softcopy only. 

► WebSphere Commerce Best Practices in Web 2.0 Store, SG24-7647 

► WebSphere Commerce High Availability and Performance Solutions, 
SG24-7512 

► WebSphere Commerce Line-Of-Business Tooling Customization, SG24-761 9 


Online resources 

The following Web sites are also relevant as further information sources: 

► Order flow process 

http : //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?top 
i c=/com. i bm. commerce . user . doc/concepts/cosof 1 ow. htm 

► Get Order 

http: //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?top 
i c=/com. i bm. commerce. webservi ces .doc/refs/rwvgetorder . htm 

► SOI and BOD service modules 

http: //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?top 
ic=/com.ibm. commerce. developer. soa.doc/concepts/csdcompare. htm 

► Non-ATP inventory information model 

http: //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?top 
i c=/com. i bm. commerce . data . doc/concepts/ci n_imi nventoryasset3 . htm 
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► Using the Management Center 

http : //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?top 
ic=/com.ibm. commerce. management- center. doc/tasks/ttf general .htm 

► Using the DistributedMap and DistributedObjectCache interfaces for the 
dynamic cache 

http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/index.jsp7topi 
c=/com . i bm .websphere . nd . doc/i nf o/ae/ae/tdyn_di stmap . html 

► Object cache instance settings 

http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/topic/com.ibm. 
websphere . nd . doc/i nfo/ae/ae/udyn_cachei nstancescol 1 ecti on . html 

► Class DistributedObjectCache 

http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/topic/com.ibm. 
websphere . javadoc . doc/publ i c_html /api /com/i bm/websphere/cache/Di stri 
butedObjectCache.html 

► IBM Extended Cache Monitor for IBM WebSphere Application Server 
technology preview 

http : //www. i bm.com/devel operworks/websphere/downl oads/cache_moni tor . 
html 

► Data service layer 

http : //publ i b . boul der . i bm. com/i nfocenter/wchel p/v7r0m0/topi c/com. i bm 
. commerce. developer. soa.doc/concepts/csddsl .htm?resul tof=%22%44%73%6 
c%2 2%2 0%2 2%64%7 3%6 c%2 2%2 0 

► Business Object Document (BOD) 

http: //publ ib.boulder.ibm.com/infocenter/wchel p/v7rOmO/index. jsp?top 
ic=/com.ibm. commerce. base. doc/mi sc/Bus iness_0bject_Document_%28B0D%2 
9.htm 

► Get Request and the Show Response 

http: //publ ib.boulder.ibm.com/infocenter/wchel p/v7rOmO/index. jsp?top 
i c=/com. i bm. commerce . webservi ces .doc/concepts/cwvget . htm 

► Dojo 

http://www.dojotool kit.org/docs 

► Get Request and the Show Response 

http: //publ ib.boulder.ibm.com/infocenter/wchel p/v7rOmO/index. jsp?top 
ic=/com.ibm. commerce. web20storesol ution.refapp.doc/concepts/csm_web2 
O_intro.htm 
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► Web 2.0 store solution 


http : //publ ib.boulder.ibm.com/infocenter/wchel p/v7r0m0/index. jsp?top 
i c=/com . i bm. commerce . web20storesol ut i on . ref app . doc/ref s/rsm_web20_st 
orepages.htm 

► Enabling Distributed Order Management (DOM) integration 

http: //publ ib.boulder.ibm.com/infocenter/wchel p/v7rOmO/index. jsp?top 
ic=/com.ibm. commerce. dom-i ntegrati on. doc/tasks/tsmbopi sinstal 1 _d u p . h 
tm 


How to get Redbooks 

You can search for, view, or download Redbooks, Redpapers, Technotes, draft 
publications and Additional materials, as well as order hardcopy Redbooks 
publications, at this Web site: 
ibm.com/redbooks 


Help from IBM 

IBM Support and downloads 
ibm.com/support 
IBM Global Services 
ibm.com/services 


Related publications 51 1 
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Index 


A 

access control framework 394 
access control policy 250, 395 
Accessible rich Internet application (AH I A) 37 
accordion widget 34 

AcknowledgelnventoryRequirement 91,117 

AcknowledgeOrder 91 

acpload 395-396 

acpload command 397 

acpload.log 252, 397 

Action 67 

action code 92 

action mappings 394 

Activity Builder 72 

activity templates 70 

add-on store archive 47 

addPaymentlnstruction service 239 

address book 51 

Advanced B2B Direct starter store 47 
Ajax 40, 44 
Ajax checkout 40 
Ajax service 1 30 

AllSitellsersViews action group 248 
analytics 6 
Android 179 

application and process integration 1 0 
application development 10 
application infrastructure 10 
ARTS 24 

Association for Retail Technology Standards 

(ARTS) 15,22,426 

ATP, see available to promise (ATP). 

attribute dictionary 46 

attribute filtering 63 

auctions 46 

available to promise (ATP) 30, 78-79, 81 , 83, 86, 
134 

inventory management system 81 
non-ATP inventory 81 
non-ATP inventory management system 81 
avgOverallRating parameters 359 
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B 

B2B contracts 399 
B2C store 30 

back-end system integration 84 
basic composite store archive 38 
BazaarVoice 54, 58 
behavioral track 4 
Best deal calculation 64 
biConfig.xml 401 
billing address create view 237 
billing address selection view 237 
Blackberry 179 

BOPIS, see buy online, pick up in store 
Branch 68 

brick-and-mortar store 30-31 
BrowseDepartments.jspf 184 
browsing 7 
budget 2 

Business Activity Monitoring (BAM) 1 7 

business logic and views 38 

Business Object Document (BOD) 91 

business object schema 74 

business objects 74 

business-to-business starter stores 46 

buy online, pick up in store 1 9-21 , 30-31 , 83, 86, 

134 

buy online, return in store 19 

c 

CachedFooterDisplay.jsp 184 
CachedHeaderDisplay.jsp 184 
CachedltemDisplay.jsp 350 
CachedProductDisplay.jsp 348 
call center 78 
call center support 7 
campaigns 6 

CancellnventoryReservation 92 
Cascading Style Sheet (CSS) 37 
cascading style sheet (CSS) 390 
catalog browsing 86 
catalog entry 74 
catalog group 74 
catalog manager 46 
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CatalogEntryDataBean 346 

CatalogSearchResultsDisplayView 1 84 

CategoriesDisplay 1 84 

category name 418 

category pages 32 

Change Flow pages 40 

ChangeOrder sen/ice 80, 89 

channel events 1 0 
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